Victron SmartShunt installieren – meine Anleitung für Camper, Auto und Smart‑Home

👉 Direkt auf YouTube schauen und abonnieren:
Smart Home & More auf YouTube

Als Technikliebhaber und Camper habe ich mich schon oft gefragt, wie viel Strom eigentlich noch in meiner Batterie steckt. Die Spannung ist ein guter Anhaltspunkt, aber sie verrät nicht immer, wie viel Kapazität wirklich übrig ist. Deshalb habe ich mich entschieden, den Victron SmartShunt zu installieren. Dieser kleine Helfer ersetzt klassische Batteriemonitore, misst Strom und Spannung und berechnet daraus den Ladezustand. In diesem Blogbeitrag nehme ich dich mit auf meine Reise und erkläre dir Schritt für Schritt, wie auch du den Victron SmartShunt installieren kannst, um deine Batterie in Camper, Auto oder Haus zuverlässig zu überwachen.

Ich arbeite mich dabei vom grundsätzlichen Verständnis bis zur vollständigen Integration in Home Assistant vor. Du erhältst Tipps zu verschiedenen Ausführungen des Shunts, zur Verkabelung, zur Einrichtung der Victron‑App und zur Nutzung eines Bluetooth‑Proxys. Außerdem zeige ich dir, wie ich den Victron SmartShunt installieren und anschließend in Home Assistant visualisieren konnte, inklusive einer hübschen Batterieanzeige und nützlichen Automatisierungen.

Warum den Victron SmartShunt installieren?

Als Erstes stellt sich die Frage: Warum sollte ich überhaupt einen Victron SmartShunt installieren? Die Antwort liegt in der präzisen Messung und Visualisierung. Anders als simple Spannungsmesser misst der SmartShunt nicht nur die Spannung, sondern auch den Stromfluss und berechnet daraus den Ladezustand der Batterie. In meinem Camper ermöglicht mir das eine verlässliche Autarkieplanung. Im Auto sehe ich, ob die Starterbatterie bei langen Standzeiten schwächelt, und im Haus kann ich Speicherbatterien von Solaranlagen überwachen. Ein weiterer Vorteil: Durch Bluetooth‑Funktionalität kann ich die Werte drahtlos auslesen und in mein Smart‑Home integrieren.

Wenn du regelmäßig campst oder ein autarkes Setup betreibst, wirst du es zu schätzen wissen, jederzeit zu wissen, wie viel Restkapazität zur Verfügung steht. Auch beim Überwintern des Autos kann es sinnvoll sein, den Victron SmartShunt zu installieren, damit die Batterie nicht unbemerkt tiefentladen wird. In Kombination mit Home Assistant ermöglicht der Shunt außerdem schicke Dashboards und Automationen – etwa eine Benachrichtigung, wenn der Ladezustand kritisch wird.

Funktionsweise des Victron SmartShunt

Bevor ich den Victron SmartShunt installieren konnte, habe ich mich mit seiner Funktionsweise beschäftigt. Der SmartShunt wird in die Masseleitung der Batterie eingebaut und misst den Strom, der hinein- und herausfließt. Zusammen mit der Batteriespannung kann er so die entnommene und zugeführte Energie berechnen und daraus den State of Charge (SoC) ermitteln. Der Vorteil: Du brauchst kein zusätzliches Display, denn die Daten lassen sich per Bluetooth oder über den integrierten VE.Direct‑Port auslesen. Ich habe mich für die Bluetooth Variante entschieden, da sie mir eine nahtlose und einfache Installation in Home Assistant ermöglicht.

Es gibt unterschiedliche Varianten: 300 A, 500 A und 1000 A. Für einen Camper reicht die 300‑A‑Variante zumeist völlig aus. In Hausinstallationen oder bei großen Off‑Grid‑Systemen können auch die größere Varianten sinnvoll sein. Bevor du den Victron SmartShunt* installieren willst, solltest du dir also überlegen, welche Ströme in deinem Setup fließen. Achte darauf, dass die maximale Stromstärke der Verbraucher und der Ladevorgänge im Rahmen des Shunts liegt.

Victron Energy SmartShunt Batteriewächter (Bluetooth) – Victron Shunt – Batteriemonitor – 6.5V-70V – 500 Amp
  • VICTRON ENERGY BATTERIEWÄCHTER: Victron Energy SmartShunt zeigt den Ladezustand der Batterie in % an und fungiert als Ladezustandsanzeige für Ihre Batterien
  • ALL-IN-ONE-BATTERIEMONITOR: Victron Energy Smartshunt ist ein hervorragender, einfach einzurichtender All-in-One-Batteriewächter. Es zeichnet Spannung, Strom, Energie und verbleibende Zeit und vieles mehr auf.
  • BLUETOOTH: Verbinden Sie Victron Energy Shunt über Bluetooth mit Ihrem Telefon oder Tablet und ändern Sie einfach die Einstellungen oder überwachen Sie Ihre Batterien – sparen Sie Platz, indem Sie kein eigenes Display verwenden
  • VERBINDEN SIE VICTRON ENERGY GX: Victron Energy GX-Gerät mit einem VE.Direct-Kabel an, um eine zweite Batterie, den Mittelpunkt der Bank oder die Temperatur zu überwachen (möglicherweise sind zusätzliche Teile erforderlich)
  • INSTALLATION: Eine unsachgemäße Installation kann gefährlich sein. Wenden Sie sich an einen Fachmann und befolgen Sie bei der Installation die elektrischen Vorschriften.

Vorbereitung für die Installation des Victron SmartShunt

Auswahl des richtigen Modells und Zubehörs

Bevor ich den Victron SmartShunt installieren konnte, musste ich das richtige Modell auswählen. Für mich war die 500‑A‑Variante passend ( nicht wegen der Leistung, sondern eher, da sie schneller lieferbar war 🙂 ) . Als Zubehör brauchst du außerdem passende Ringkabelschuhe mit einem auf die benötigte Leistung ausgelegten Kabelquerschnitt für die „Minus“ Seite (müssen dazugekauft werden), um die Kabel sicher anzuschließen, sowie eine geeignete Sicherung für den Pluspol ( wird mitgeliefert). Der SmartShunt wird zwar auf der Minus-Seite verbaut, aber der Pluspol des Geräts muss zur Stromversorgung angeschlossen werden.

Für die spätere Integration in Home Assistant habe ich mir außerdem einen ESP32* besorgt. Dieses kleine Modul dient als Bluetooth‑Proxy und leitet BLE‑Daten ins WLAN weiter. Dazu komme ich später noch.

M5Stack Atom Lite ESP32 IoT Entwicklungsboards und Kits | Development Kit C008
  • M5Stack SKU: C008
  • ESP32-basiert, RGB-LED (SK6812)
  • Eingebaute Infrarot
  • Erweiterbare Pins & Löcher
  • Programmierplattform: Arduino, UIFlow

Sicherheitshinweise

Bevor du mit der Verkabelung beginnst und den Victron SmartShunt installieren möchtest, solltest du sicherstellen, dass deine Batterie spannungsfrei ist. Entferne gegebenenfalls die Sicherungen oder trenne das System vom Netz. Arbeite mit isoliertem Werkzeug und vermeide Kurzschlüsse. Eine saubere Installation erhöht nicht nur die Sicherheit, sondern sorgt auch für präzise Messwerte.

Verkabelung und Einbau des SmartShunt

Die Verkabelung war einfacher als gedacht, aber dennoch sind ein paar Dinge zu beachten. Um den Victron SmartShunt installieren zu können, wird der Shunt in die Minusleitung der Batterie eingebaut. Alle Verbraucher müssen hinter dem Shunt angeschlossen werden, damit der Stromfluss korrekt gemessen wird.

  1. Minuspol trennen: Ich habe zunächst den Minuspol der Batterie abgeklemmt.
  2. Shunt anschrauben: Der SmartShunt besitzt zwei große Schraubanschlüsse. Eine Seite (Batterieseite) wird direkt mit dem Minuspol der Batterie verbunden, die andere (Lastseite) führt zu den Verbrauchern.
  3. Pluspol des Shunts: Am Gehäuse befindet sich eine kleine Schraubklemme für den Pluspol. Hier habe ich eine Leitung von der Batterie über eine Sicherung angeschlossen. Das versorgt die Elektronik des Shunts.

Hinweis: Achte unbedingt darauf, die Ein- und Ausgangsseite nicht zu vertauschen. Wenn du den Victron SmartShunt installieren möchtest und die Anschlüsse vertauschst, wird der Stromfluss invertiert – die Messwerte sind dann negativ. Du kannst es zwar softwareseitig korrigieren, aber besser ist eine korrekte Installation.

Victron SmartShunt installieren in der Victron‑App

Nachdem der Shunt angeschlossen war, habe ich die Victron‑App aus dem App Store heruntergeladen. Mit ihr lässt sich der SmartShunt via Bluetooth konfigurieren. Der Pairing‑Code lautet standardmäßig 000000, falls du das Gerät noch nicht geändert hast.

Pairing und erste Schritte

Nach dem Öffnen der App hat die App den SmartShunt automatisch gefunden. Ich habe das Gerät ausgewählt und die Verbindung hergestellt. Um den Victron SmartShunt zu installieren, musste ich einige grundlegende Einstellungen vornehmen:

  • Batterie‑Kapazität: Hier habe ich den Wert meiner LiFePo4‑Batterie (200 Ah) eingetragen.
  • Ladeschluss‑Spannung: In meinem Fall 14,1 V.
  • Entladeschwelle: Ich habe 10 % gewählt, um die Batterie zu schützen.
  • Schweifstrom: 0,5 %, damit der Shunt erkennt, wann die Batterie voll ist.
  • Ladewirkungsgrad: 95 %.
  • SOC‑Reset: Es gibt die Möglichkeit, den SoC manuell zurückzusetzen. Das ist nützlich nach einem vollständigen Ladezyklus.
Victron SmartShunt installieren - Batterieeinstellungen

Hinweis: Verwende die zu deiner Batterie passenden Einstellungen. Die hier gezeigten Settings dienen nur als Beispiel!

Die App zeigt auch die MAC‑Adresse und den Verschlüsselungkey an. Letzteren habe ich mir abgeschrieben, denn für die Integration in Home Assistant benötige ich die sogenannte Advertisement‑Key, um die verschlüsselten Daten zu entschlüsseln. Beim Victron SmartShunt installieren solltest du dir diesen Schlüssel unbedingt notieren.

Victron SmartShunt installieren - Key und Mac

Victron SmartShunt installieren und Bluetooth‑Proxy nutzen

Um die Daten des SmartShunts im ganzen Haus verfügbar zu machen, reicht die Bluetooth‑Verbindung allein oft nicht aus, insbesondere wenn der Camper oder die Garage etwas weiter entfernt ist. Deshalb habe ich einen ESP32 als Bluetooth‑Proxy eingerichtet. Damit lassen sich BLE‑Geräte wie der SmartShunt über das WLAN ins Smart‑Home integrieren.

ESP32 als Bluetooth‑Proxy einrichten

Zuerst habe ich den ESP32 per USB an meinen Computer angeschlossen und die ESP‑Home‑Bluetooth Proxy- Installer ‑Seite geöffnet. Über den Wizard lässt sich mit wenigen Klicks ein generisches Bluetooth‑Proxy‑Image flashen. Nachdem der Flash‑Vorgang abgeschlossen war, habe ich den ESP32 mit meinem WLAN verbunden.

Anschließend habe ich den ESP32 direkt mit meinem Home Assistant verbunden. Im Lovelace‑Dashboard erschien ein neues Gerät, das ich „Bluetooth Proxy Video WW“ genannt habe. Nun ist der Victron SmartShunt im wahrsten Sinne des Wortes bereit für die nächste Stufe.

Tipp: Du kannst mehrere Bluetooth‑Proxies im Haus verteilen, wenn du noch andere BLE‑Sensoren hast. Sie erweitern die Reichweite und bringen die Daten zuverlässig ins Netzwerk.

Victron SmartShunt installieren - Bluetooth Proxy

Victron SmartShunt installieren in Home Assistant

Der spannendste Teil für mich war die Integration in Home Assistant. Um die verschlüsselten Daten des SmartShunts auswerten zu können, braucht man eine passende Integration.

HACS installieren und Victron BLE Integration hinzufügen

Zunächst habe ich den Home Assistant Community Store (HACS) eingerichtet. Das ist ein Zusatzmodul, das viele Community‑Integrationen bereitstellt. Über die GitHub‑Seite von Victron BLE habe ich die Integration in HACS hinzugefügt und installiert.

Danach musste Home Assistant neu gestartet werden. Unter „Einstellungen → Geräte und Dienste“ konnte ich „Victron BLE“ als neue Integration auswählen. Es wurde der SmartShunt automatisch gefunden, und ich musste nur noch den vorher notierten Advertisement‑Key eingeben. Hier ist eine typische YAML‑Struktur, mit der der Schlüssel hinterlegt wird:

Nach dem Speichern erschienen neue Sensoren in meinem Home Assistant: Batteriespannung, Ladestrom, Ladezustand und vieles mehr. Damit war der Schritt erledigt und der Victron SmartShunt erfolgreich in Home Assistant integriert.

Dashboard mit Batterieanzeige erstellen

Jetzt wollte ich die Daten nicht nur sehen, sondern auch ansprechend präsentieren. Dafür eignet sich die Button‑Card aus HACS. Mit ihr lässt sich eine Batterieanzeige gestalten, die ihre Farbe abhängig vom Ladezustand ändert.

Button‑Card konfigurieren

Ich habe eine neue Button‑Card im Dashboard erstellt und folgende Konfiguration verwendet:

type: custom:button-card
entity: sensor.shunt_battery
icon: mdi:battery
name: Batterie
show_state: true
show_label: true
label: |
  [[[
    return `${states['sensor.shunt_voltage'].state} V | ${states['sensor.shunt_current'].state} A`
  ]]]
state:
  - operator: <=
    value: 20
    color: red
  - operator: <=
    value: 50
    color: orange
  - operator: ">"
    value: 50
    color: green

Diese Card zeigt mir den aktuellen Ladezustand, die Spannung und den Strom an. Die Farbe des Symbols wechselt bei 20 % auf Rot und bei 50 % auf Orange. Für mich war es wichtig, beim Victron SmartShunt installieren auch eine optische Rückmeldung zu haben, wann die Batterie sich dem Entladungsbereich nähert.

Automatisierungen und Benachrichtigungen

Ein weiterer großer Vorteil beim Victron SmartShunt installieren ist die Möglichkeit, Automatisierungen in Home Assistant zu nutzen. Ich wollte eine Benachrichtigung bekommen, sobald der Ladezustand unter 20 % fällt. Dafür habe ich eine einfache Automation erstellt:

alias: Batteriewarnung
description: ""
triggers:
  - trigger: numeric_state
    entity_id:
      - sensor.shunt_battery
    for:
      hours: 0
      minutes: 1
      seconds: 0
    below: 20
conditions: []
actions:
  - action: notify.mobile_app_iphone_tobias
    metadata: {}
    data:
      message: Batterie ist unter 20 % Achtung !
      title: Batteriewarnung
mode: single

Mit dieser Automation bekomme ich nach einer Minute unterhalb des Schwellenwerts eine Push‑Nachricht. Dadurch kann ich reagieren, bevor die Batterie zu tief entladen wird. Beim Victron SmartShunt installieren gehört für mich eine solche Benachrichtigung unbedingt dazu.

Verlaufdiagramme und Datenanalyse

Neben der aktuellen Anzeige möchte ich auch wissen, wie sich der Ladezustand über längere Zeit verändert. Home Assistant bietet eine Verlaufdiagramm‑Karte. Ich habe für meine Batterie ein Diagramm angelegt, das die letzten 168 Stunden (sieben Tage) darstellt. So kann ich sehen, wann ich besonders viel Strom verbraucht habe und wie sich das Laden und Entladen verhält.

Es wäre auch möglich, die Daten in Grafana auszuwerten oder in ein anderes Dashboard zu exportieren. Das bietet sich an, wenn du den Victron SmartShunt und die Daten langfristig beobachten möchtest.

Alternativ lassen sich Daten auch über Grafana und Influxdb in Home Assistant visualisieren. Darauf bin ich in einem anderen Blog Beitrag genauer eingegangen.

Victron SmartShunt installieren - Verlaufsdiagramm

Weitere Anwendungsmöglichkeiten des Victron SmartShunt

Der Einsatz beschränkt sich nicht nur auf Camper. Auch im Auto kann man den Victron SmartShunt installieren, um die Starterbatterie zu überwachen. So weißt du immer, ob sie nach längerer Standzeit noch genügend Kapazität hat. Im Haus lässt sich der Shunt an Solarspeicher anschließen, um die Effizienz der Anlage zu überwachen.

Ein weiterer Vorteil: Über den VE.Direct‑Port kannst du den SmartShunt auch mit dem Cerbo GX oder anderen Victron‑Systemen verbinden. Das habe ich bisher nicht ausprobiert, es steht aber auf meiner To‑Do‑Liste. Wenn du dazu einen Erfahrungsbericht wünschst, lass es mich in den Kommentaren wissen.

Fazit: Lohnt es sich, den Victron SmartShunt zu installieren?

Für mich war es eine der lohnendsten Erweiterungen meines Campers. Seitdem ich den Victron SmartShunt installieren und in Home Assistant integrieren konnte, habe ich jederzeit einen Überblick über den Ladezustand meiner Batterie. Die Kombination aus präzisen Messwerten, ansprechender Visualisierung und praktischen Benachrichtigungen gibt mir die Sicherheit, länger autark zu bleiben und die Batterie vor Tiefentladung zu schützen.

Weitere Blogbeiträge zum Thema „smarter Camper“

Smarter Camper

Ich hoffe, diese ausführliche Anleitung hilft dir weiter. Falls du Fragen hast oder Anmerkungen, hinterlasse gerne einen Kommentar bei Youtube. Viel Spaß beim Basteln!

Uptime Kuma Home Assistant Integration – Ausfälle erkennen & Dienste überwachen

👉 Direkt auf YouTube schauen und abonnieren:
Smart Home & More auf YouTube

Wenn plötzlich Licht und WLAN nicht mehr funktionieren, weil der MQTT-Broker down ist – dann ist es zu spät. Ich zeige dir, wie du mit Uptime Kuma Home Assistant zuverlässig überwachst und automatisch informiert wirst, wenn etwas schiefläuft.


🔍 Warum ich Uptime Kuma Home Assistant nutze

In meinem Smart Home gibt es viele Dienste: MQTT, EVCC, mein Blog, das Forum und mein Mailserver. Und alle sind kritisch. Was passiert, wenn einer davon ausfällt? Richtig – vieles funktioniert nicht mehr. Genau hier kommt Uptime Kuma Home Assistant ins Spiel.

Das kostenlose Monitoring-Tool Uptime Kuma ist nicht nur unglaublich einfach zu bedienen – es ist mittlerweile auch direkt in Home Assistant integrierbar. Dank der neuen Funktion im August 2025 Update werden Sensoren automatisch erkannt und eingebunden.

Uptime Kuma Home Assistant  - Übersicht Sensoren


⚙️ Uptime Kuma in Home Assistant installieren

Die Installation geht schnell – ich führe dich durch jeden Schritt:

  1. Add-On Store öffnen
  2. Nach Uptime Kuma suchen
  3. Installieren und starten

Wichtig: Achte auf Portkonflikte – z. B. nutzt Grafana bei mir bereits Port 3001, daher musste ich Kuma auf 3002 umstellen.

Uptime Kuma in Home Assistant - Port Konfiguration


🧪 Ersten Dienst überwachen – HTTPS-Monitor anlegen

Ich beginne meist mit einem einfachen Monitor für meine eigene Website:

  • Typ: HTTPS
  • URL: https://smarthomeundmore.de
  • Zertifikatsüberwachung aktivieren
  • Gruppe: extern
  • Tag: Webseite

Uptime Kuma in Home Assistant - HTTPS Dienst

Mit einem Klick auf Speichern siehst du bereits ein erstes Diagramm zur Erreichbarkeit deiner Website.

📡 MQTT-Dienste überwachen mit Uptime Kuma Home Assistant

Jetzt wird’s spannender: MQTT ist das Herzstück vieler Home Assistant Setups.

🔧 Automatisierung vorbereiten

Ich lasse Home Assistant alle 10 Sekunden eine MQTT-Nachricht senden ( es genügen auch alle 60 Sekunden):

Uptime Kuma Home Assistant Automatisierung

alias: MQTT Heartbeat
description: ""
triggers:
  - trigger: time_pattern
    seconds: /10
conditions: []
actions:
  - action: mqtt.publish
    metadata: {}
    data:
      topic: uptimekuma/heartbeat
      payload: alive
mode: single

👉 Hier findest du noch einen weiteren Blogbeitrag zum Thema MQTT

🖥️ MQTT-Monitor in Uptime Kuma einrichten

  • Typ: MQTT
  • Host: IP deines Brokers (z. B. 192.168.101.79)
  • Port: 1883
  • Topic: uptime-kuma/heartbeat
  • Benutzer & Passwort: dein MQTT-Login

🖐️ Weitere sinnvolle Sensoren – Ping & TCP

Ping Monitor:

Ich überwache z. B. meinen Proxmox-Node:

  • Typ: Ping
  • Host: 192.168.101.96
  • Gruppe: lokal
  • Tag: Server

TCP Monitor:

Ideal für Dienste wie EVCC, die über spezifische Ports laufen:

  • Typ: TCP
  • URL: https://homeassistant.local:7070 ( oder die IP deiner EVCC Instanz ! )
  • Gruppe: lokal
  • Tag: EVCC

Uptime Kuma in Home Assistant - Monitoring

🔗 Uptime Kuma in Home Assistant integrieren

Dank des neuen Updates geht das nun direkt:

  1. Uptime Kuma öffnen → Einstellungen → API-Schlüssel generieren
  2. Home Assistant → Integration hinzufügen → Uptime Kuma
  3. URL & API-Key eintragen (z. B. http://localhost:3002)
  4. Sensoren werden automatisch importiert

Uptime Kuma in Home Assistant - Integration

📊 Sensoren auf dem Dashboard visualisieren

Ich nutze eine Markdown-Karte, um alle Dienste aufzulisten, die gerade nicht erreichbar sind:



{% set down_list = states.sensor
  | selectattr('entity_id', 'search', '_status$')
  | selectattr('state', 'eq', 'down')
  | map(attribute='entity_id')
  | list %}
{% if down_list | length == 0 %}
✅ Alle Dienste sind online.
{% else %}
⚠️ Die folgenden Dienste sind **nicht erreichbar**:
{% for entity_id in down_list %}
- {{ (state_attr(entity_id, 'friendly_name') or entity_id).replace(' Status', '') }}
{% endfor %}
{% endif %}

🛎️ Automatisierung bei Ausfällen – Benachrichtigung in Echtzeit

Mit folgender Automatisierung lasse ich Home Assistant automatisch eine Nachricht auslösen, wenn ein Sensor down geht:

Uptime Kuma in Home Assistant - Benachrichtigung

alias: Uptime Kuma – Ausfallbenachrichtigung
description: Benachrichtigt bei Ausfällen der Uptime Kuma Sensoren
triggers:
  - value_template: >
      {% for entity_id in integration_entities('uptime_kuma') if
      entity_id.endswith('_status') and states(entity_id) == 'down' %}
        {{ true }}
        {% break %}
      {% endfor %}
    trigger: template
actions:
  - data:
      title: "Uptime Kuma: Ausfall erkannt"
      message: >
        Die folgenden Dienste sind aktuell **nicht erreichbar**: {%- for
        entity_id in integration_entities('uptime_kuma') if
        entity_id.endswith('_status') and states(entity_id) == 'down' %} - {{
        (state_attr(entity_id, 'friendly_name') or entity_id).replace(' Status',
        '') }} {%- endfor %}
      notification_id: uptime_kuma_down
    action: persistent_notification.create
mode: single

Natürlich kannst du hier auch Push-Nachrichten, Alexa-Ausgaben oder TTS einbauen.


💡 Gruppenstatus überwachen – lokal & extern

Ich nutze Gruppen wie lokal und extern, um logisch zu trennen:

  • Fällt ein Dienst aus der Gruppe lokal aus, wird der Gruppensensor lokal ebenfalls als down markiert.
  • So kann ich gezielt auf Gruppen triggern – z. B. alle lokalen Dienste sind nicht erreichbar = kritischer Alarm!

Uptime Kuma in Home Assistant - Gruppenzustände

🧠 Fazit – Warum ich Uptime Kuma Home Assistant jedem empfehle

Uptime Kuma Home Assistant ist für mich ein Gamechanger:

✅ Einfache Einrichtung
✅ Flexible Integration
✅ Visuelle Darstellung
✅ Automatische Benachrichtigung
✅ Sicherheit durch Echtzeit-Monitoring

Besonders bei Diensten wie meinem Blog, Forum oder Mailserver ist mir wichtig, sofort zu erfahren, wenn etwas ausfällt. Dank der neuen Home Assistant Integration brauche ich keine Workarounds mehr – die Sensoren werden automatisch eingebunden, gruppiert und getrackt.


🔁 Weiterführende Links (interne Verlinkung)

👉 Blogbeitrag: MQTT Explorer Home Assistant
👉 Blogbeiträge: EVCC


📣 Deine Meinung?

Kennst du schon Uptime Kuma? Nutzt du es bereits? Schreib es mir gerne in die Kommentare bei Youtube – ich freue mich auf den Austausch.

Radon messen im Smart Home – Gerätevergleich & Home‑Assistant‑Integration für gesunde Raumluft

👉 Direkt auf YouTube schauen und abonnieren:
Smart Home & More auf YouTube

Radon messen im Smart Home – Geräte, Analyse und Home‑Assistant‑Integration

Radon ist ein radioaktives Edelgas, das aus dem Zerfall von Uran im Erdreich entsteht und durch Risse oder Undichtigkeiten in Gebäudefundamenten in unsere Wohnräume eindringen kann. Das Gas ist unsichtbar und geruchlos; die meisten Betroffenen bemerken seine Anwesenheit erst durch Messungen. Studien zeigen, dass Radon nach dem Rauchen eine der häufigsten Ursachen für Lungenkrebs in Deutschland ist – es wird geschätzt, dass rund fünf Prozent aller Lungenkrebstodesfälle im Land auf eine erhöhte Radonbelastung zurückzuführen sind. Mit der Verabschiedung der Strahlenschutzverordnung (StrlSchV) zum Jahresende 2018 gibt es in Deutschland erstmals verbindliche Referenzwerte für Innenräume: Für Neu‑ und Altbauten gilt im Jahresmittel ein Referenzwert von 300 Becquerel pro Kubikmeter (Bq/m³). Die Weltgesundheitsorganisation (WHO) und auch das Bundesamt für Strahlenschutz (BfS) empfehlen sogar, die Radonkonzentration möglichst unter 100 Bq/m³ zu halten. Ab etwa 100 Bq/m³ steigt das Risiko, an Lungenkrebs zu erkranken, deutlich an; bei 100 Bq/m³ erhöht sich das Risiko um bis zu 16 Prozent.

Bezugsquellen*


air-Q Radon – Luftanalysator mit 5 Sensoren

  • Menschen in Radon-Risikogebieten sollten Räume in denen sie sich oft aufhalten, regelmäßig auf Radon überwachen. In Abhängigkeit von der Radon-Belastung können Maßnahmen wie Lüften oder bauliche Maßnahmen ergriffen werden.
  • Unternehmen in Radon-Risikogebieten können mit Hilfe des air-Q radon Orientierungsmessungen vornehmen, um sicherzugehen, dass Mitarbeiter keiner Belastung ausgesetzt sind. Regelmäßige Radon-Messungen sind je nach geetzlichen Rahmenbedingungen sogar vorgeschrieben.
  • Familien können sichergehen, dass die Luft unbelastet ist. Ausgasungen aus z.B. Möbeln, Teppichen oder Spielzeugen werden vom air-Q radon auch erkannt, ein gesundes Leben und gesunder Schlaf gefördert und damit Krankheiten vorgebeugt.
  • Smart Home-Nutzern und technikbegeisterten Menschen bietet der air-Q viele Möglichkeiten zur intelligenten Vernetzung.
  • Forscher und Datenanalytiker können alle Daten exportieren und sie zur eigenen Datenauswertung in Drittanbietersoftware (Excel, Statistikprogramme) nutzen. Über die air-Q eigene API (nur air-Q Science!) lassen sich alle Daten auch direkt und in Echtzeit in eine eigene Datenbank senden.


AIR-Q radon science (11 Sensoren) Luftqualitätsmessgerät, weiß

  • Menschen in Radon-Risikogebieten sollten Räume in denen sie sich oft aufhalten, regelmäßig auf Radon überwachen. In Abhängigkeit von der Radon-Belastung können Maßnahmen wie Lüften oder bauliche Maßnahmen ergriffen werden.
  • Unternehmen in Radon-Risikogebieten können mit Hilfe des air-Q radon Orientierungsmessungen vornehmen, um sicherzugehen, dass Mitarbeiter keiner Belastung ausgesetzt sind. Regelmäßige Radon-Messungen sind je nach geetzlichen Rahmenbedingungen sogar vorgeschrieben.
  • Familien können sichergehen, dass die Luft unbelastet ist. Ausgasungen aus z.B. Möbeln, Teppichen oder Spielzeugen werden vom air-Q radon auch erkannt, ein gesundes Leben und gesunder Schlaf gefördert und damit Krankheiten vorgebeugt.
  • Die Anwesenheit von Menschen im Raum erkennen und warnen, wenn eigentlich gerade niemand anwesend sein darf (CO2 Sensor notwendig!)
  • Smart Home-Nutzern und technikbegeisterten Menschen bietet der air-Q viele Möglichkeiten zur intelligenten Vernetzung.

Was ist Radon und wie gelangt es ins Haus?

Radon entsteht im natürlichen Zerfallsprozess von Uran und Radium. Im Boden bildet sich Radongas, das durch Diffusion und Unterdruck in den Oberboden aufsteigt. In Innenräumen kann es sich dann ungehindert anreichern, wenn es unbemerkt über Spalten, Fugen, Rohrdurchführungen oder poröse Materialien in Keller und Erdgeschoss eindringt. Besonders im Winter, wenn beheizte Innenräume einen höheren Unterdruck erzeugen und die Lüftung oft reduziert wird, steigt das Risiko für erhöhte Radonkonzentrationen, wie auch im Video erläutert wird. Die geografische Lage spielt ebenfalls eine Rolle: Die Radonkarte des Bundesamts für Strahlenschutz (BfS) zeigt, dass vor allem Süd‑ und Ostdeutschland, das Erzgebirge, der Schwarzwald oder ehemalige Bergbauregionen erhöhte Werte aufweisen. Dennoch können auch in radonarmen Gebieten hohe Werte auftreten, da die Werte von Gebäude zu Gebäude stark variieren.

Gesundheitliche Risiken und Grenzwerte

Radon zerfällt zu radioaktiven Tochterprodukten, die sich an kleinste Staubpartikel binden. Beim Einatmen dieser Partikel können die Radonfolgeprodukte in der Lunge verbleiben und das umliegende Gewebe durch ionisierende Strahlung schädigen. Epidemiologische Studien und Erfahrungen aus dem Bergbau belegen, dass Radon ein signifikanter Risikofaktor für Lungenkrebs ist. Der deutsche Gesetzgeber orientiert sich an der EU‑Richtlinie 2013/59/Euratom und hat einen Referenzwert von 300 Bq/m³ festgelegt; damit soll überprüft werden, ob Gegenmaßnahmen wie Lüftung oder Abdichtung erforderlich sind. Die WHO sieht bereits ab 100 Bq/m³ Handlungsbedarf.

Messgeräte im Vergleich: Exposimeter, Air‑Q, Radon Eye und EcoCube

Um die Radonkonzentration im eigenen Haus zu beurteilen, gibt es zwei grundsätzliche Messansätze: passive Messungen mit Exposimetern und aktive Messungen mit elektronischen Sensoren. Ich habe verschiedene Lösungen getestet und miteinander verglichen. Ziel des Tests war es, die Messgeräte zu bewerten und ihre Integration in Home Assistant zu untersuchen.

Exposimeter – die langfristige Methode zur Radonmessung

Radon messen im Smart Home - Exposimeter

Ein Exposimeter ist eine kleine Messdose, die über einen längeren Zeitraum (typischerweise drei bis zwölf Monate) im Wohnraum platziert wird. Weil Radon schwerer als Luft ist, sollte das Exposimeter in Bodennähe stehen. Nach der Messung wird das Exposimeter an ein Labor geschickt und analysiert. Der Vorteil: Man erhält einen zuverlässigen Mittelwert über einen langen Zeitraum, der vom BfS anerkannt wird und für offizielle Messungen (beispielsweise im Rahmen der gesetzlichen Messpflicht) genutzt werden kann. Der Nachteil: Kurzfristige Spitzenwerte oder saisonale Schwankungen werden verschleiert; während einer Lüftungsphase kann der Mittelwert niedriger ausfallen, obwohl es vorher hohe Peaks gab. Deshalb empfehle ich, das Exposimeter nur als erste Indikation zu nutzen und parallele elektronische Messungen durchzuführen.

Air‑Q Radon (Science) – High‑End‑Sensor mit vielen Messgrößen

Radon messen im Smart Home - Air-Q Radon

Der Air‑Q Radon (Science) zählt zu den umfangreichsten Radon‑Messgeräten auf dem Markt. Ich habe die „Science“-Variante verwendet, die neben Radon noch flüchtige organische Verbindungen (VOCs), Feinstaub in verschiedenen Größenklassen (PM 1, 2,5, 4, 10), Temperatur, relative und absolute Luftfeuchtigkeit, Luftdruck sowie den Taupunkt misst. Dank dieser Sensorvielfalt erhält man ein umfassendes Bild der Raumluftqualität und kann Korrelationen zwischen Radon und anderen Parametern erkennen. Die Daten werden lokal per WLAN bereitgestellt; eine Cloud‑Anbindung ist optional und lässt sich komplett deaktivieren, was im Hinblick auf Datenschutz positiv hervorzuheben ist. Das Gerät hat in der gesamten Testphase absolut zuverlässig und mit einer hohen Messfrequenz gearbeitet: Alle paar Sekunden liefert der Air‑Q einen neuen Wert. Allerdings hat die Qualität ihren Preis – je nach Ausstattung liegen die Kosten zwischen 400 und 700 Euro.

Radon Eye – Bluetooth‑Sensor mit gutem Preis‑Leistungs‑Verhältnis

Radon messen im Smart Home - RadonEye rd200

Der Radon Eye ist ein elektronischer Radon‑Sensor, der über Bluetooth kommuniziert. Im Gegensatz zum Air‑Q setzt der Hersteller vollständig auf lokale Datenübertragung; das Gerät sendet keine Daten ins Internet. Der Messintervall liegt bei etwa einer Stunde, wodurch eine gewisse Glättung erfolgt. Für viele Anwendungen reicht dieser Intervall aus, denn Radonkonzentrationen ändern sich nicht sekündlich. Der Radon Eye kostet rund 180 Euro und ist damit deutlich günstiger als der Air‑Q. Für Home‑Assistant‑Nutzer gibt es eine Integration über HACS (Home Assistant Community Store), die den Sensor problemlos in Dashboards einbindet. Wer keinen Home Assistant nutzt, kann die Werte nur vor Ort per App abrufen; eine Fernüberwachung ist ohne Heimautomation nicht vorgesehen.

EcoCube – Kompakter WLAN‑Sensor mit Cloud‑Anbindung

Radon messen im Smart Home -EcoCube (EcoSense)

Der EcoCube misst Radon ebenfalls elektronisch, allerdings werden die Daten zwingend über die Cloud des Herstellers synchronisiert. Diese Abhängigkeit empfinde ich als ein wenig störend, da man sich registrieren und persönliche Daten angeben muss. In meinen Tests hat der Sensor allerdings gute Werte geliefert; die Messfrequenz ist geringer als beim Air‑Q, aber vermutlich höher als beim Radon Eye (geschätzt kürzer als eine Stunde). Der EcoCube lässt sich über eine eigene App auslesen und per HACS in Home Assistant integrieren – allerdings funktioniert die Integration nur über die Cloud. Während der Testphase kam es zu Aussetzern, bei denen der Sensor neu gestartet werden musste; ob dies ein Einzelfall war, lässt sich nicht abschließend beurteilen. Mit einem Preis im Bereich des Radon Eye und durch seine kompakte Bauform ist der EcoCube dennoch eine interessante Option für Nutzer, die ihre Räumlichkeiten überwachen wollen.

Messstrategie: Platzierung, Auswertung und Vergleich

Die Praxistests im Video zeigen, dass die Positionierung der Sensoren entscheidend ist. Weil Radon schwerer als Luft ist, sollte man alle Geräte in Bodennähe aufstellen – idealerweise im Keller oder Erdgeschoss. Ich habe die Sensoren in meinem Studio getestet, wobei ich sie direkt nebeneinander platziert habe, um direkte Vergleiche zu ermöglichen. Radon hat eine Halbwertszeit von 3,8 Tagen. Dieser radioaktive Zerfall führt zu Messabweichungen: Selbst wenn zwei Geräte nebeneinander stehen, messen sie den Zerfall zeitlich leicht versetzt. Deshalb ist es sinnvoll, Tagesmittelwerte zu betrachten und differenzielle Analysen durchzuführen. In meinen Auswertungen, die über Grafana und ApexCharts visualisiert werden, erkennt man die Abweichungen zwischen den Tageswerten der Geräte. Die Differenzen liegen bei wenigen Becquerel – der Radon Eye misst im Schnitt etwa 3,3 Bq/m³ weniger als der Air‑Q und der EcoCube liegt 0,27 Bq/m³ darüber. Trotz unterschiedlicher Messfrequenzen verlaufen die Kurven weitgehend parallel, was für eine gute Vergleichbarkeit spricht.

Um eine Extremsituation nachzustellen, habe ich einen Lüftungsstopp simuliert, indem ich alle Türen und Fenster für einen Tag in dem Raum verschlossen gehalten habe. Innerhalb kurzer Zeit stiegen die Radonwerte auf über 175 Bq/m³ an. Sobald gelüftet wird, sinkt die Konzentration rasch wieder ab. Für Smart‑Home‑Nutzer eröffnet sich hier ein einfaches Anwendungsfeld: Man kann einen Schwellenwert definieren (zum Beispiel 100 Bq/m³) und mit Hilfe von Home Assistant eine Benachrichtigung auslösen oder automatisch Fenster‑Aktoren ansteuern. In der Grafik lässt sich erkennen, wie durch gezieltes Lüften – selbst ohne bauliche Maßnahmen – die Werte zuverlässig unter 100 Bq/m³ bleiben.

Integration in Home Assistant

Ein wesentlicher Aspekt des Videos ist die Integration der Messgeräte in Home Assistant. Ich nutze diese Plattform, um alle Sensoren zu visualisieren und Automatisierungen zu erstellen.

  • Air‑Q‑Integration: Der Air‑Q kann per WLAN mit Home Assistant verbunden werden, ohne dass Daten das lokale Netzwerk verlassen. Dank der umfangreichen Sensorik lassen sich Korrelationen zwischen Luftfeuchtigkeit, Temperatur und Radonwerten visualisieren. Ich habe die Cloud‑Funktion deaktiviert und ausschließlich auf die lokalen Daten zugegriffen.
  • Radon Eye: Für den Radon Eye steht eine HACS‑Integration zur Verfügung. Diese verwendet Bluetooth‑Low‑Energy (BLE). Voraussetzung ist ein passender BLE‑Adapter im Home‑Assistant‑Server (z. B. ein ESP32 oder ein Atom M5 Lite). Die Werte werden stündlich aktualisiert und können in Dashboards oder Automatisierungen genutzt werden.
  • EcoCube: Der EcoCube lässt sich ebenfalls per HACS einbinden – jedoch nur über die Cloud. Diese Abhängigkeit hat einen entscheidenden Nachteil: Wenn eine Internetverbindung nicht verfügbar ist oder die Server nicht erreichbar sind, erhalte ich keine Messwerte. Wer Wert auf Datenschutz legt, sollte besser zu einem der anderen Geräte greifen.

Blogbeitrag : Wie du HACS installierst ( in 3 Minuten )

Was tun bei hohen Radonwerten?

Wenn Messungen dauerhaft Werte über 300 Bq/m³ ergeben, sollten Hausbesitzer weitere Schritte einleiten. Zunächst ist regelmäßiges Stoßlüften die einfachste Maßnahme; wie die Tests zeigen, reduziert dies die Konzentration schnell. In Regionen mit sehr hoher Bodenbelastung oder bei großen Rissen im Fundament kann allerdings Lüften allein nicht ausreichen. Dann ist es sinnvoll, die Ursachen zu beseitigen. Ich bin kein Experte auf dem Gebiet, deshalb empfehle ich in solchen Fällen, sich an einen Radon‑Fachbetrieb zu wenden und entsprechende Maßnahmen zu erörtern.

Fazit und Ausblick

Ich hoffe, ihr konntet verstehen, wie wichtig eine Radonmessung im eigenen Zuhause ist. Obwohl die gesetzliche Schwelle bei 300 Bq/m³ liegt, empfiehlt es sich, Werte möglichst unter 100 Bq/m³ zu halten. Einfache Maßnahmen wie regelmäßiges Stoßlüften können Radon innerhalb kurzer Zeit senken. Moderne elektronische Sensoren erleichtern die Überwachung und ermöglichen mit Home Assistant automatisierte Maßnahmen. Der Air‑Q liefert extrem detaillierte Daten, ist jedoch kostenintensiv; der Radon Eye bietet ein gutes Preis‑Leistungs‑Verhältnis und arbeitet ohne Cloud; der EcoCube ist kompakt, erfordert aber eine Cloud‑Anbindung. Das passive Exposimeter liefert einen Langzeitwert und eignet sich zur behördlich anerkannten Messung.

Für Smart‑Home‑Enthusiasten lohnt sich die Integration der Sensoren in Home Assistant. Mit Grafana und ApexCharts lassen sich die Daten übersichtlich darstellen, Trends erkennen und Aktionen automatisieren. In einem Folgevideo werde ich die Integration der drei Sensoren in Home Assistant zeigen, wie Anbindung und Visualisierung eingerichtet werden. Den Code für die Apex‑Chart‑Cards und auch das Grafana‑Dashboard werde ich auf meinem Blog verfügbar machen.

Proxmox API Home Assistant Backup automatisieren – VMs überwachen & sichern

👉 Direkt auf YouTube schauen und abonnieren:
Smart Home & More auf YouTube

Einleitung

Proxmox API Home Assistant Backup – in diesem Praxis‑Guide lernst du, wie du mithilfe der Proxmox API den Zustand deiner virtuellen Maschinen abfragst, Dashboards in Home Assistant erstellst und Backups automatisierst. Statt auf HACS setzt du dabei auf REST‑Sensoren und API‑Calls, um deine VMs sicher zu überwachen und zu sichern.

Vorbereitung in Proxmox – Benutzer, Token und Rechte einrichten

Bevor du in Home Assistant loslegen kannst, musst du Proxmox entsprechend vorbereiten.

API‑Benutzer und Token anlegen

Erstelle im Proxmox DataCenter einen neuen User (z. B. homeassistant) ohne Passwort, denn wir arbeiten mit API‑Tokens. Wähle als Realm pve und lege anschließend unter API Token einen neuen Token für diesen User an. Achte darauf, Privilege Separation zu deaktivieren. Kopiere dir den Token sofort, da er später nicht mehr angezeigt wird.

Proxmox API Home Assistant Backup - User

Proxmox API Home Assistant Backup - API Token

Rollen konfigurieren

Für den Zugriff auf VM‑Informationen und Backups benötigen wir passende Rollen:

  • Lege eine neue Rolle (z. B. homeassistant-role) mit den Privilegien VM.Audit, Datastore.Audit und Datastore.AllocateSpace, VM.Backup an.
  • Weise diese Rolle dem User auf den benötigten Pfaden zu: dem Node (/nodes/pve-lerch) und den VMs (/vms/*).

Diese granularen Berechtigungen sorgen dafür, dass Home Assistant lediglich die benötigten Daten abrufen und einen Proxmox API Home Assistant Backup auslösen darf.

Proxmox API Home Assistant Backup - Rollen definieren

Home Assistant konfigurieren – REST‑Sensoren anlegen

Im nächsten Schritt richten wir Home Assistant ein. Falls du noch keinen File Editor installiert hast, installiere diesen im Add-on Store von Home Assistant.

Proxmox API Home Assistant Backup - Add-on File Editor

REST‑Sensor für VM‑Informationen

Über den YAML‑Eintrag rest: definieren wir einen Sensor, der regelmäßig einen GET‑Request an die Proxmox API sendet. Die URL lautet beispielsweise:

https://<proxmox-host>/api2/json/nodes/pve-larch/qemu

Als Header gibst du Authorization: PVEAPIToken=<user>@pve!<token-id>=<token> an. Im value_template kannst du die JSON‑Antwort weiterverarbeiten und die Daten in Attributen speichern.

  - resource: https://192.168.101.69:8006/api2/json/nodes/pvelerch/qemu
    method: GET
    headers:
      Authorization: "PVEAPIToken=homeassistant@pve!proxmox=be729a21-e76b-430b-84bf-40d096d035a6"
    verify_ssl: false
    scan_interval: 10
    sensor:
      - name: "PVELerch VM Raw"
        unique_id: pvelerch_vm_raw
        value_template: "OK"
        json_attributes:
          - data

Vergiss nicht, Home Assistant neu zu starten, damit der Sensor angelegt wird. Anschließend siehst du eine Liste aller VMs als JSON‑Attribut, inklusive ihrer Namen, IDs und Status.

REST‑Sensor für LXC‑Container

Für LXC‑Container wiederholst du den Sensor mit dem Endpunkt .../lxc. Denke daran, dass nicht alle API‑Attribute identisch sind – die Belegung des Festplattenspeichers (disk-usage) steht nur bei Containern zur Verfügung.

  - resource: https://192.168.101.69:8006/api2/json/nodes/pvelerch/lxc
    method: GET
    headers:
      Authorization: "PVEAPIToken=homeassistant@pve!proxmox=be729a21-e76b-430b-84bf-40d096d035a6"
    verify_ssl: false
    scan_interval: 10
    sensor:
      - name: "PVELerch LXC Raw"
        unique_id: pvelerch_lxc_raw
        value_template: "OK"
        json_attributes:
          - data

Hier nochmal beide Rest Sensoren für die Configuration.Yaml. Beachte, dass am Anfang einmal „rest:“ stehen muss.

rest:
  - resource: https://192.168.101.69:8006/api2/json/nodes/pvelerch/qemu
    method: GET
    headers:
      Authorization: "PVEAPIToken=homeassistant@pve!proxmox=be729a21-e76b-430b-84bf-40d096d035a6"
    verify_ssl: false
    scan_interval: 10
    sensor:
      - name: "PVELerch VM Raw"
        unique_id: pvelerch_vm_raw
        value_template: "OK"
        json_attributes:
          - data
          
  - resource: https://192.168.101.69:8006/api2/json/nodes/pvelerch/lxc
    method: GET
    headers:
      Authorization: "PVEAPIToken=homeassistant@pve!proxmox=be729a21-e76b-430b-84bf-40d096d035a6"
    verify_ssl: false
    scan_interval: 10
    sensor:
      - name: "PVELerch LXC Raw"
        unique_id: pvelerch_lxc_raw
        value_template: "OK"
        json_attributes:
          - data

Dashboard gestalten – Markdown‑Karte für VM‑Übersicht

Um die Daten ansprechend zu visualisieren, kannst du eine Markdown‑Karte in deinem Home‑Assistant‑Dashboard einfügen. Im Template liest du die Attribute der Sensoren aus und listest jede VM mit Name, Uptime, Status und, bei LXC‑Containern, prozentual belegtem Speicherplatz auf.

Proxmox API Home Assistant Backup - Mark Down Karte

{% set vms = state_attr('sensor.pvelerch_vm_raw', 'data') or [] %}
{% set lxcs = state_attr('sensor.pvelerch_lxc_raw', 'data') or [] %}

## 🖥️ Virtuelle Maschinen (QEMU)

{% for vm in vms | sort(attribute='vmid') %}
  {% set days = vm.uptime // 86400 %}
  {% set hours = (vm.uptime % 86400) // 3600 %}
  {% set minutes = (vm.uptime % 3600) // 60 %}
  {% if days > 0 %}
    {% set uptime_str = days ~ 'd ' ~ hours ~ 'h' %}
  {% else %}
    {% set uptime_str = hours ~ 'h ' ~ minutes ~ 'm' %}
  {% endif %}
- **{{ vm.vmid }}** | {{ vm.name }} | Uptime: {{ uptime_str }} | {{ "🟢" if vm.status == "running" else "🔴" }}
{% endfor %}

## 📦 LXC-Container

{% for lxc in lxcs | sort(attribute='vmid') %}
  {% set days = lxc.uptime // 86400 %}
  {% set hours = (lxc.uptime % 86400) // 3600 %}
  {% set minutes = (lxc.uptime % 3600) // 60 %}
  {% if days > 0 %}
    {% set uptime_str = days ~ 'd ' ~ hours ~ 'h' %}
  {% else %}
    {% set uptime_str = hours ~ 'h ' ~ minutes ~ 'm' %}
  {% endif %}
- **{{ lxc.vmid }}** | {{ lxc.name }} | Disk: {{ ((lxc.disk / lxc.maxdisk) * 100) | round(1) if lxc.maxdisk and lxc.maxdisk > 0 else 'n/a' }} % | Uptime: {{ uptime_str }} | {{ "🟢" if lxc.status == "running" else "🔴" }}
{% endfor %}

So siehst du live, wenn eine VM gestoppt wird oder startet. Über Automationen kannst du sogar Benachrichtigungen verschicken, wenn sich der Status ändert. Achte darauf, dass du die Entitäten auf deine Entitätsnamen anpasst.

sensor.pvelerch_vm_raw

sensor.pvelerch_lxc_raw

Monitoring & Test – Live‑Überwachung von VMs

Teste deine Konfiguration, indem du eine VM in Proxmox stoppst und wieder startest. Die Änderungen sollten in der Markdown‑Karte nach dem nächsten Scan‑Intervall sichtbar sein. Dieses Szenario zeigt, wie zuverlässig die REST‑API im Zusammenspiel mit Home Assistant funktioniert.

Backups per API auslösen

Eines der mächtigsten Features der Proxmox API ist die Möglichkeit, Backups zu starten.

Rollen erweitern

Erweitere deine Rolle um die Berechtigungen VM.Backup und Datastore.AllocateSpace, damit der User Backups auslösen darf ( haben wir schon im ersten Schritt getan ). Vergiss nicht, auch den Storage‑Pfad (/storage) mit dieser Rolle zu verknüpfen.

Proxmox API Home Assistant Backup - User Zugriffsrechte

REST‑Command für VZDump

In Home Assistant legst du unter rest_command: einen neuen Befehl an. Die URL endet diesmal auf /vzdump, die Methode ist POST, und als Payload übergibst du Parameter wie vmid, mode (z. B. snapshot), storage und compress.

rest_command:
  pvelerch_backup:
    url: "https://192.168.101.69:8006/api2/json/nodes/pvelerch/vzdump"
    method: POST
    headers:
      Authorization: "PVEAPIToken=homeassistant@pve!proxmox=be729a21-e76b-430b-84bf-40d096d035a6"
      Content-Type: "application/x-www-form-urlencoded"
    payload: "vmid=100,101,104,106,108,112,113,114,116,119,102,103,105&mode=snapshot&storage=PBS&compress=zstd"
    verify_ssl: false

Ein Aufruf dieses REST‑Commands startet sofort den Backup‑Job in Proxmox. Über die Home‑Assistant‑Entwicklerwerkzeuge kannst du den Befehl testen. In einer Automation oder auf einem Button platziert, kannst du einen Proxmox API Home Assistant Backup sogar zeit‑ oder ereignisgesteuert auslösen.

Fazit & Ausblick

Mit ein wenig Konfigurationsaufwand lässt sich die Proxmox API hervorragend in Home Assistant integrieren. Du kannst den Zustand deiner VMs und LXC‑Container überwachen, in Dashboards visualisieren und sogar Backups per Knopfdruck starten. Nutze diese Lösung als Grundlage für weitere Automatisierungen, zum Beispiel um Benachrichtigungen zu verschicken oder externe Dienste einzubinden.

Wenn du mehr über Energie‑Management erfahren willst, schau dir auch unseren Beitrag zur EVCC‑Einbindung in Home Assistant an. Für Einsteiger in Proxmox empfehlen wir den Artikel Proxmox Grundinstallation Schritt für Schritt.

Link‑Liste