À propos
TrueNAS CE est une intégration qui surveille et contrôle un système TrueNAS Community Edition depuis Home Assistant. Elle communique localement avec l'instance TrueNAS à l'aide d'une clé API et nécessite TrueNAS 25.04 ou une version plus récente. Elle ajoute des capteurs pour la charge système, la mémoire, la température, la durée de fonctionnement, les pools, les datasets, les disques, les interfaces réseau, les alertes et l'expiration des certificats, ainsi que des capteurs binaires, des boutons, des interrupteurs et des entités de mise à jour. Des actions permettent de démarrer ou d'arrêter des services, des machines virtuelles, des conteneurs et des applications, de lancer des tâches de synchronisation cloud, rsync, de réplication et de snapshot, de créer un snapshot de dataset, et de redémarrer ou d'éteindre le système. Des mises à jour poussées pilotées par les événements couvrent plusieurs domaines, avec un repli sur l'interrogation périodique, et l'intervalle d'interrogation, l'unité de taille des données et les groupes surveillés peuvent être réglés dans les options. Elle se configure dans l'interface, et Home Assistant peut la découvrir sur le réseau.
Résumé automatique du README et du code de kayl-codes/homeassistant-truenas, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Fonctionne en local Communique avec tes appareils sur ton propre réseau. Aucun cloud de fournisseur entre les deux.
Détection automatique Home Assistant la repère sur le réseau et propose de l’ajouter.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Connexion
- Nom de l'intégrationUn nom convivial pour distinguer cette instance TrueNAS des autres, si tu en configures plusieurs.
- HôteLe nom d'hôte ou l'adresse IP de ton instance TrueNAS, sans "https://", chemin ni barre oblique finale.
- Clé APIUne clé API générée dans TrueNAS sous Credentials > API Keys. Laisse vide pour conserver une clé déjà configurée lors de la reprise d'une configuration existante.
- Vérifier le certificat SSLVérifie le certificat SSL de l'instance TrueNAS. Désactive cette option uniquement si tu utilises un certificat auto-signé que tu ne peux pas valider autrement.
- Ignorer les tâches cron désactivéesExclut de la surveillance les tâches cron désactivées dans TrueNAS ; aucune entité capteur n'est créée pour elles.
- Unité de taille des données (GB ou GiB)Choisis si les tailles de données sont affichées en unités décimales (GB) ou binaires (GiB).
Réauthentifier TrueNAS
- Clé APILa nouvelle clé API générée dans TrueNAS sous Credentials > API Keys.
Modification de la connexion
- HôteLe nom d'hôte ou l'adresse IP de ton instance TrueNAS, sans "https://", chemin ni barre oblique finale.
- Clé APIUne clé API générée dans TrueNAS sous Credentials > API Keys. Laisse vide pour conserver la clé actuelle.
- Vérifier le certificat SSLVérifie le certificat SSL de l'instance TrueNAS. Désactive cette option uniquement si tu utilises un certificat auto-signé que tu ne peux pas valider autrement.
- Ignorer les tâches cron désactivéesExclut de la surveillance les tâches cron désactivées dans TrueNAS ; aucune entité capteur n'est créée pour elles.
- Unité de taille des données (GB ou GiB)Choisis si les tailles de données sont affichées en unités décimales (GB) ou binaires (GiB).
- Ajouter/mettre à jour les phrases secrètes des datasetsSaisis des paires DatasetName#PassPhrase (une par ligne, par exemple tank/encrypted#MySecret) pour ajouter ou mettre à jour des phrases secrètes enregistrées. Laisse vide pour conserver les phrases secrètes existantes sans changement. Utilise l’action passphrase_remove pour supprimer une phrase secrète enregistrée à partir du chemin de son dataset.
Après la mise en place
- Intervalle d'interrogation (secondes)La fréquence, en secondes, à laquelle l'instance TrueNAS est interrogée pour obtenir des données à jour.
- Unité de taille des donnéesChoisis si les tailles de données sont affichées en unités décimales (GB) ou binaires (GiB).
- ComportementSélectionne les comportements actifs
- Groupes surveillésDésélectionne les groupes que tu n'utilises pas pour réduire le nombre de capteurs
Textes issus du code de kayl-codes/homeassistant-truenas. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesProblèmes de disque/pool, en bonne santé, Lien, Expiré
- BoutonsNettoyer les statistiques orphelines, Annuler la migration, Actualiser les données, Lancer le scrub, Mettre le scrub en pause, Reprendre le scrub, Arrêter le scrub, Exécuter
- CapteursAlertes, Connexions SMB, Durée de fonctionnement, Température, Charge CPU court terme, Charge CPU moyen terme, Charge CPU long terme, Utilisation du CPU, Utilisation de la mémoire, Taille de l'ARC, Mémoire totale, Mémoire libre et 30 autres
- InterrupteursActivé
Actions
- Lancement de cloudsyncDémarre une tâche cloudsync (cible le capteur cloudsync).
- Interruption de cloudsyncInterrompt une tâche cloudsync en cours (cible le capteur cloudsync).
- Lancement de rsyncDémarre une tâche rsync à la demande (cible le capteur de tâche rsync).
- Lancement de réplicationDémarre une tâche de réplication à la demande (cible le capteur de réplication).
- Lancement de tâche de snapshotExécute maintenant une tâche de snapshot périodique (cible le capteur de tâche de snapshot). Remarque : si le schéma de nommage de la tâche n'a qu'une résolution à la minute (par exemple auto-%Y-%m-%d_%H-%M), l'exécuter deux fois dans la même minute échoue sur TrueNAS, car le nom du snapshot existe déjà.
- Créer un snapshot de datasetCrée un snapshot ZFS à la demande du dataset ciblé. Le snapshot est pris immédiatement et nommé "custom-" suivi d'un horodatage, indépendamment de toute tâche de snapshot périodique (cible un capteur de dataset).
- Redémarrer TrueNASRedémarre le système TrueNAS (cible le capteur Durée de fonctionnement).
- Éteindre TrueNASÉteint le système TrueNAS (cible le capteur Durée de fonctionnement).
- Actualiser les données de TrueNASForce une nouvelle interrogation immédiate de TrueNAS afin que les automatisations puissent agir sur des données à jour sans attendre la prochaine interrogation (cible le capteur Durée de fonctionnement).
- Démarrage de serviceDémarre un service TrueNAS (cible le capteur binaire du service).
- Arrêt de serviceArrête un service TrueNAS (cible le capteur binaire du service).
- Redémarrage de serviceRedémarre un service TrueNAS (cible le capteur binaire du service).
- Rechargement de serviceRecharger un service TrueNAS (cible le capteur binaire du service).
- Démarrage de VMDémarrer une machine virtuelle (cible le capteur binaire de la VM).Champs : Surallocation de mémoire
- Arrêt de VMArrêter une machine virtuelle (cible le capteur binaire de la VM).Champs : Forcer
- Redémarrage de VMRedémarrer une machine virtuelle (cible le capteur binaire de la VM).
- Démarrage de conteneurDémarrer un conteneur (instance Incus ; cible le capteur binaire du conteneur).
- Arrêt de conteneurArrêter un conteneur (instance Incus ; cible le capteur binaire du conteneur).
- Redémarrage de conteneurRedémarrer un conteneur (instance Incus ; cible le capteur binaire du conteneur).
- Démarrage d’applicationDémarrer une application (cible le capteur binaire de l’application).
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Statistiques TrueNAS orphelines, Migration vers TrueNAS CE : retour en arrière possible, Échec du retour en arrière de la migration vers TrueNAS CE, Ancienne intégration TrueNAS laissée en place
Extrait du README
Note: This is an independent integration, originally forked from the
and now maintained as a standalone project. See the Changelog for a summary of everything that has changed per version.
- CPU usage (%)
- Memory (bytes)
- Network RX/TX per interface (bytes/sec)
- Block I/O Read/Write (bytes)
S’affiche dans Vulpo :
carte Bascule rapide, carte Bouton, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 378 partagent leurs statistiques
- Étoiles GitHub
- 55
- Connexion
- Fonctionne en local
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v2.13.0,
- Catégorie
- Informatique et réseau, NAS et serveurs
- Type
- Intégration de la Marketplace
- Marque
- TrueNAS
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
truenas_ce- Problèmes
- Signaler un problème
