Überblick
Unraid Management Agent verbindet Home Assistant mit dem Unraid Management Agent, der auf einem Unraid-Server läuft. Die Integration fügt Sensoren, Binärsensoren, Schalter, Tasten, Zahlen, Ereignisse und Update-Entitäten für das Array, Paritätsprüfungen, Docker-Container, virtuelle Maschinen, Festplatten, Lüfter, GPUs, Netzwerkkarten und ZFS-Pools hinzu. Die Aktionen umfassen das Starten, Stoppen und Neustarten von Containern und VMs sowie die Steuerung von Array und Paritätsprüfung. Die Daten kommen über eine lokale WebSocket-Verbindung an, als Ausweichlösung wird alle 30 Sekunden abgefragt. Ein schreibgeschützter Modus beschränkt die Integration auf Sensoren, damit Home Assistant auf dem Server nichts starten, stoppen oder neu starten kann. Sie wird im Netzwerk automatisch gefunden und in der Oberfläche eingerichtet, sie bringt eigene Dashboard-Karten mit und zeigt Reparaturhinweise bei Problemen wie Festplattenfehlern oder einer fehlgeschlagenen Verbindung.
Zusammenfassung der README und des Codes von tinkerologie/ha-unraid-management-agent, 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.
Mit Unraid-Server verbinden
- Host
- Port
- WebSocket für Echtzeit-Updates aktivieren
- API-TokenErforderlich, wenn in den Einstellungen des Agents ein API-Token festgelegt ist (Einstellungen > Unraid Management Agent > Authentication). Leer lassen, wenn die Authentifizierung deaktiviert ist.
Wird auch beim Ändern der Verbindung abgefragt.
Unraid Management Agent erneut authentifizieren
- API-TokenDas API-Token, das aktuell in den Einstellungen des Agents festgelegt ist (Einstellungen > Unraid Management Agent > Authentication). Es wird bei jeder Anfrage als Bearer-Token gesendet.
Nach der Einrichtung
- Update-Prüfung für Container aktivierenPrüft Docker-Container regelmäßig auf verfügbare Image-Updates. Das kann die Abfrage verlangsamen und zusätzliche Netzwerkanfragen verursachen. Erstellt außerdem für jeden Container eine Update-Entität, über die sich sein Image-Update installieren lässt.
- Entitäten zur Lüftersteuerung aktivierenErstellt Sensoren für die Lüfterdrehzahl und Steuerungsentitäten. Deaktiviere dies, wenn dein System keine steuerbaren Lüfter hat.
- Schreibgeschützten Modus aktivieren (nur Sensoren)Erstellt nur Sensoren. Schalter, Tasten und Zahlen-Steuerelemente werden nicht erstellt (vorhandene werden entfernt), und die Aktionen der Integration werden verweigert, damit Home Assistant auf dem Server nichts starten, stoppen oder neu starten kann. Update-Entitäten zeigen weiterhin verfügbare Updates an, bieten aber keine Installation an.
- WebSocket für Echtzeit-Updates aktivierenWebSocket liefert sofortige Updates statt Abfragen. Wenn deaktiviert, werden die Daten alle 30 Sekunden abgefragt.
- Docker-Container als separate Geräte anzeigenGibt jedem Container ein eigenes Gerät unter dem Docker-Gerät des Servers, das seine Schalter, die Neustart-Taste und die Metrik-Sensoren mit kurzen Namen (Running, CPU, Memory) enthält. Wenn deaktiviert, bleiben die Container-Entitäten auf dem Server-Gerät und tragen den Namen des Containers.
- GPUs als separate Geräte anzeigenGibt jeder GPU ein eigenes Gerät unter dem Server, das ihre Sensoren für Auslastung, Temperatur, Leistung, Energie und VRAM mit kurzen Namen enthält. Wenn deaktiviert, bleiben die GPU-Sensoren auf dem Server-Gerät und tragen den Namen der GPU.
- Netzwerkkarten als separate Geräte anzeigenGibt jeder PCI-Netzwerkkarte ein eigenes Gerät unter dem Server, mit ihren ASIC-, PHY- und MAC-Temperaturen sowie pro Port der Verbindungsgeschwindigkeit und der Diagnosewerte des eingesteckten optischen Moduls (Modultemperatur und Spannung, RX- und TX-Leistung, Alarm- und Warnflags, Hersteller und Teilenummer). Erfordert einen Agent, der Netzwerkkarten meldet. Wenn deaktiviert, werden keine Netzwerkkarten-Entitäten erstellt (vorhandene werden entfernt).
- USB-Sensorcontroller als separate Geräte anzeigenGibt jedem USB-Sensorcontroller, den der Agent erkennt (zum Beispiel ein Aquacomputer Octo), ein eigenes Gerät unter dem Server, das seine Lüfter- und Temperatursensoren mit ihren lm-sensors-Bezeichnungen enthält ("Array Fan1", "Coolant Temp"). Die Entitäts-IDs bleiben erhalten. Wenn deaktiviert, bleiben diese Sensoren auf dem Server-Gerät. Ein in sensors.conf als Durchfluss bezeichneter Kanal ("Coolant Flow") wird in beiden Fällen als Durchflusskanal angezeigt; er meldet weiterhin RPM.
- Virtuelle Maschinen als separate Geräte anzeigenGibt jeder VM ein eigenes Gerät unter dem VM-Gerät des Servers, das ihren Ein-/Aus-Schalter, die Steuertasten und die Metrik-Sensoren (CPU, Arbeitsspeicher, Netzwerk- und Festplattenraten) enthält. Wenn deaktiviert, bleiben die VM-Schalter und Tasten auf dem Server-Gerät, und es werden keine VM-Sensoren erstellt.
- ZFS-Pools als separate Geräte anzeigenGibt jedem ZFS-Pool ein eigenes Gerät unter dem Server, das seine Sensoren für Belegung, Zustand, Scrub und Fehler mit kurzen Namen enthält, dazu Zusammenfassungen zum Laufwerkszustand: heißeste Laufwerkstemperatur, höchster NVMe-Verschleiß, Medienfehler, ausfallende Laufwerke und eine Laufwerksanzahl mit Details pro Laufwerk. Der Laufwerkszustand erfordert Agent 2026.10 oder neuer. Wenn deaktiviert, bleiben die Pool-Entitäten auf dem Server-Gerät und tragen den Namen des Pools.
- Quelle der CPU-TemperaturWoher der CPU-Temperatursensor seinen Wert bezieht. "Automatic" verwendet die CPU-Temperatur, die der Agent meldet. Wenn diese auf deinem Board den falschen Chip zeigt (zum Beispiel einen Mainboard-Kanal wie nct6798 CPUTIN statt k10temp Tctl), wähle stattdessen den hwmon-Kanal, der verwendet werden soll. Der Sensor ist nicht verfügbar, solange der gewählte Kanal nicht gemeldet wird.
Texte aus dem Code von tinkerologie/ha-unraid-management-agent. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- BinärsensorenArray gestartet, Paritätsprüfung läuft, Parität gültig, USV verbunden, ZFS verfügbar, Update verfügbar, Flash intakt, Mover läuft, Paritätsprüfung geplant, Dienst, Container-Updates verfügbar, Status und 7 weitere
- TastenArray starten, Array stoppen, Array-Festplattenstatistik löschen, Paritätsprüfung starten, Paritätsprüfung stoppen, Paritätsprüfung pausieren, Paritätsprüfung fortsetzen, Alle Benachrichtigungen archivieren, System herunterfahren, System neu starten, Stopp erzwingen, Neustart und 3 weitere
- EreignisseBenachrichtigung, Alarm
- SensorenCPU-Auslastung, RAM-Auslastung, CPU-Temperatur, Mainboard-Temperatur, CPU-Leistung, DRAM-Leistung, Laufzeit, Chipsatz-Temperatur, CPU-Governor, CPU-Frequenz, Swap-Auslastung, Swappiness und 89 weitere
- SchalterStrom, Läuft, Autostart
- UpdatesUnraid OS, Bild
Aktionen
- Container startenEinen Docker-Container startenFelder: Container-ID
- Container stoppenEinen Docker-Container stoppenFelder: Container-ID
- Container neu startenEinen Docker-Container neu startenFelder: Container-ID
- Container pausierenEinen laufenden Docker-Container pausierenFelder: Container-ID
- Container fortsetzenEinen pausierten Docker-Container fortsetzenFelder: Container-ID
- Container entfernenEinen Docker-Container entfernenFelder: Container-ID, Bild entfernen
- Container-Autostart festlegenDen Autostart für einen Docker-Container aktivieren oder deaktivierenFelder: Container-ID, Aktiviert
- VM startenEine virtuelle Maschine startenFelder: VM-ID
- VM stoppenEine virtuelle Maschine stoppenFelder: VM-ID
- VM neu startenEine virtuelle Maschine neu startenFelder: VM-ID
- VM pausierenEine laufende virtuelle Maschine pausieren (Suspend to RAM)Felder: VM-ID
- VM fortsetzenEine pausierte virtuelle Maschine fortsetzenFelder: VM-ID
- VM in den Ruhezustand versetzenEine virtuelle Maschine in den Ruhezustand versetzen (Suspend to Disk)Felder: VM-ID
- VM zwangsweise stoppenEine virtuelle Maschine zwangsweise stoppen (entspricht dem Ausschalten)Felder: VM-ID
- VM zurücksetzenEine virtuelle Maschine zwangsweise zurücksetzenFelder: VM-ID
- Array startenDas Unraid-Array starten
- Array stoppenDas Unraid-Array stoppen
- Array-Laufwerksstatistiken löschenDie Lese- und Schreibstatistiken der Array-Laufwerke löschen
- Paritätsprüfung startenEine Paritätsprüfung starten
- Paritätsprüfung stoppenDie laufende Paritätsprüfung stoppen
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Verbindung zum Unraid Server fehlgeschlagen, SMART-Fehler am Laufwerk erkannt, Warnung: hohe Laufwerkstemperatur, Kritische Laufwerkstemperatur, Array-Parität ungültig, Paritätsprüfung hängt möglicherweise
Aus der README
This custom integration connects Home Assistant to the Unraid Management Agent (UMA) running on your Unraid server. It delivers comprehensive monitoring, interactive controls, dynamic entity discovery, real-time WebSocket telemetry, and a bundled suite of custom Lovelace dashboard cards.
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 271 teilen Analysedaten
- GitHub-Sterne
- 48
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v2026.10.1,
- Kategorie
- Computer und Netzwerk, NAS und Server
- Art
- Marketplace-Integration
- Marke
- Unraid
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
unraid_management_agent- Probleme
- Problem melden












