Überblick
TrueNAS CE ist eine Integration, die ein TrueNAS Community Edition System von Home Assistant aus überwacht und steuert. Sie kommuniziert lokal mit der TrueNAS-Instanz über einen API-Schlüssel und benötigt TrueNAS 25.04 oder neuer. Sie fügt Sensoren für Systemlast, Arbeitsspeicher, Temperatur, Laufzeit, Pools, Datasets, Festplatten, Netzwerkschnittstellen, Warnungen und Zertifikatsablauf hinzu, dazu Binärsensoren, Tasten, Schalter und Update-Entitäten. Aktionen können Dienste, virtuelle Maschinen, Container und Apps starten oder stoppen, Cloud-Sync-, rsync-, Replikations- und Snapshot-Aufgaben ausführen, einen Dataset-Snapshot erstellen sowie das System neu starten oder herunterfahren. Ereignisgesteuerte Push-Updates decken mehrere Bereiche ab, mit Rückfall auf Polling, und das Abfrageintervall, die Einheit der Datengröße und die überwachten Gruppen lassen sich in den Optionen anpassen. Sie wird in der Oberfläche eingerichtet, und Home Assistant kann sie im Netzwerk erkennen.
Zusammenfassung der README und des Codes von kayl-codes/homeassistant-truenas, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Verbinden
- Name der IntegrationEin aussagekräftiger Name, um diese TrueNAS-Instanz von anderen zu unterscheiden, falls du mehrere einrichtest.
- HostDer Hostname oder die IP-Adresse deiner TrueNAS-Instanz, ohne "https://", Pfad oder abschließenden Schrägstrich.
- API-SchlüsselEin API-Schlüssel, erzeugt in TrueNAS unter Credentials > API Keys.
- SSL-Zertifikat überprüfenDas SSL-Zertifikat der TrueNAS-Instanz überprüfen. Nur deaktivieren, wenn du ein selbstsigniertes Zertifikat verwendest, das sich sonst nicht validieren lässt.
- Deaktivierte Cronjobs bei manueller Ausführung überspringenIn TrueNAS deaktivierte Cronjobs beim manuellen Ausführen überspringen.
- Einheit der Datengröße (GB oder GiB)Wähle, ob Datengrößen in dezimalen (GB) oder binären (GiB) Einheiten angezeigt werden.
TrueNAS erneut authentifizieren
- API-SchlüsselDer neue API-Schlüssel, erzeugt in TrueNAS unter Credentials > API Keys.
Verbindung ändern
- HostDer Hostname oder die IP-Adresse deiner TrueNAS-Instanz, ohne "https://", Pfad oder abschließenden Schrägstrich.
- API-SchlüsselEin API-Schlüssel, erzeugt in TrueNAS unter Credentials > API Keys.
- SSL-Zertifikat überprüfenDas SSL-Zertifikat der TrueNAS-Instanz überprüfen. Nur deaktivieren, wenn du ein selbstsigniertes Zertifikat verwendest, das sich sonst nicht validieren lässt.
- Deaktivierte Cronjobs bei manueller Ausführung überspringenIn TrueNAS deaktivierte Cronjobs beim manuellen Ausführen überspringen.
- Einheit der Datengröße (GB oder GiB)Wähle, ob Datengrößen in dezimalen (GB) oder binären (GiB) Einheiten angezeigt werden.
- Dataset-Passphrasen hinzufügen/aktualisierenDatasetName#Passphrase-Paare (eine pro Zeile, z. B. tank/encrypted#MeinGeheimnis) eingeben, um Passphrasen zu speichern oder zu aktualisieren. Leer lassen, um bestehende Passphrasen unverändert zu behalten. Zum Löschen einer gespeicherten Passphrase die Aktion passphrase_remove mit dem Dataset-Pfad verwenden.
Nach der Einrichtung
- Abrufintervall (Sekunden)Wie oft, in Sekunden, die TrueNAS-Instanz nach aktuellen Daten abgefragt wird.
- Einheit der DatengrößeWähle, ob Datengrößen in dezimalen (GB) oder binären (GiB) Einheiten angezeigt werden.
- VerhaltenWähle aus, welche Verhaltensweisen aktiv sind
- Überwachte GruppenWähle Gruppen ab, die du nicht nutzt, um die Anzahl der Sensoren zu reduzieren
Texte aus dem Code von kayl-codes/homeassistant-truenas.
Entitäten
- BinärsensorenDatenträger-/Pool-Probleme, Gesund, Verbindung, Abgelaufen
- TastenVerwaiste Statistiken bereinigen, Migration rückgängig machen, Daten aktualisieren, Scrub ausführen, Scrub pausieren, Scrub fortsetzen, Scrub stoppen, Ausführen
- SensorenWarnungen, SMB-Verbindungen, Laufzeit, Temperatur, CPU-Last kurzfristig, CPU-Last mittelfristig, CPU-Last langfristig, CPU-Auslastung, Speicherauslastung, ARC-Größe, Speicher gesamt, Speicher frei und 30 weitere
- SchalterAktiviert
Aktionen
- Cloudsync ausführenStartet einen Cloudsync-Job (Cloudsync-Sensor als Ziel).
- Cloudsync abbrechenBricht einen laufenden Cloudsync-Job ab (Cloudsync-Sensor als Ziel).
- Rsync ausführenStartet eine Rsync-Aufgabe auf Anforderung (Rsync-Aufgaben-Sensor als Ziel).
- Replikation ausführenStartet eine Replikationsaufgabe auf Anforderung (Replikations-Sensor als Ziel).
- Snapshot-Aufgabe ausführenFührt eine periodische Snapshot-Aufgabe sofort aus (Snapshot-Aufgaben-Sensor als Ziel). Hinweis: Hat das Namensschema der Aufgabe nur Minutenauflösung (z. B. auto-%Y-%m-%d_%H-%M), schlägt eine zweite Ausführung innerhalb derselben Minute auf TrueNAS fehl, weil der Snapshot-Name bereits existiert.
- Dataset-Snapshot erstellenErstellt einen sofortigen ZFS-Snapshot des angesteuerten Datasets. Der Snapshot wird unmittelbar erstellt und custom-<timestamp> genannt, unabhängig von einer periodischen Snapshot-Aufgabe (Dataset-Sensor als Ziel).
- TrueNAS neu startenStartet das TrueNAS-System neu (Uptime-Sensor als Ziel).
- TrueNAS herunterfahrenFährt das TrueNAS-System herunter (Uptime-Sensor als Ziel).
- TrueNAS-Daten aktualisierenErzwingt eine sofortige erneute Abfrage von TrueNAS, damit Automatisierungen mit aktuellen Daten arbeiten können, ohne auf die nächste Abfrage zu warten (Uptime-Sensor als Ziel).
- Dienst startenStartet einen TrueNAS-Dienst (Dienst-Binärsensor als Ziel).
- Dienst stoppenStoppt einen TrueNAS-Dienst (Dienst-Binärsensor als Ziel).
- Dienst neu startenStartet einen TrueNAS-Dienst neu (Dienst-Binärsensor als Ziel).
- Dienst neu ladenLädt einen TrueNAS-Dienst neu (Dienst-Binärsensor als Ziel).
- VM startenStartet eine virtuelle Maschine (VM-Binärsensor als Ziel).Felder: Speicher überbuchen
- VM stoppenStoppt eine virtuelle Maschine (VM-Binärsensor als Ziel).Felder: Erzwingen
- VM neu startenStartet eine virtuelle Maschine neu (VM-Binärsensor als Ziel).
- Container startenStartet einen Container (Incus-Instanz; Container-Binärsensor als Ziel).
- Container stoppenStoppt einen Container (Incus-Instanz; Container-Binärsensor als Ziel).
- Container neu startenStartet einen Container neu (Incus-Instanz; Container-Binärsensor als Ziel).
- App startenStartet eine App (App-Binärsensor als Ziel).
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Verwaiste TrueNAS-Statistiken, TrueNAS-CE-Migration — Rückgängig möglich, TrueNAS-CE-Migrations-Rollback fehlgeschlagen, Alte TrueNAS-Integration zurückgeblieben
Aus der 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)
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 378 teilen Analysedaten
- GitHub-Sterne
- 55
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v2.13.0,
- Kategorie
- Computer und Netzwerk, NAS und Server
- Art
- Marketplace-Integration
- Marke
- TrueNAS
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
truenas_ce- Probleme
- Problem melden
