Zum Inhalt

Home-Assistant-Automationen mit Blueprints sicher wiederverwenden

Veröffentlicht am 7. September 2026 · Geschätzte Lesezeit: 9 Minuten

Blueprints sind wiederverwendbare Vorlagen für Automationen: Die Logik bleibt zentral in einer YAML-Datei, während du pro Anwendung nur Bewegungsmelder, Licht und Wartezeit auswählst. So lässt sich dieselbe geprüfte Automation für mehrere Räume nutzen, ohne sie immer wieder neu zu schreiben.[1][2] Für Import, Prüfung und einen ersten Test brauchst du etwa 30 bis 45 Minuten; für den optionalen eigenen Blueprint weitere 30 Minuten.

Voraussetzungen

  • Eine aktuelle Home-Assistant-Installation mit Administratorzugang
  • Zugriff auf Einstellungen → Automatisierungen & Szenen → Blueprints
  • Ein unkritischer Bewegungsmelder und ein unkritisches Testlicht
  • Ein aktuelles vollständiges Home-Assistant-Backup

1. Backup und sicheren Rückweg vorbereiten

Öffne Einstellungen → System → Backups, erstelle ein vollständiges Backup und bewahre möglichst eine zusätzliche Kopie außerhalb des Home-Assistant-Systems auf.

Notiere außerdem, welche neue Automation und welchen Blueprint du in dieser Anleitung anlegst. Der einfache Rückweg besteht darin, zuerst die neue Automation zu deaktivieren und zu löschen und danach den nur dafür importierten Blueprint zu entfernen. Ein Backup ist besonders wichtig, wenn du später einen Blueprint aktualisierst oder mit Kontrolle übernehmen in eine normale Automation umwandelst.

2. Quelle und Blueprint vor dem Import prüfen

Ein Blueprint ist ausführbare Automationslogik. Importiere deshalb nicht einfach die erste gefundene YAML-Datei. Prüfe vorab:

  • Stammt die URL aus der offiziellen Dokumentation, dem Home-Assistant-Forum oder einem nachvollziehbaren Repository?
  • Sind Autor, Änderungsverlauf und Beschreibung plausibel?
  • Welche triggers, conditions und actions enthält die Datei?
  • Werden nur die erwarteten Geräte, Entitäten und Aktionen angesprochen?
  • Gibt es auffällige Netzwerkaufrufe, Benachrichtigungen oder Aktionen für Schlösser, Tore, Heizungen und andere sicherheitskritische Geräte?
  • Nennt der Blueprint eine benötigte Home-Assistant-Version oder zusätzliche Integrationen?

Home Assistant kann Blueprints aus dem Home-Assistant-Forum, GitHub und GitHub-Gists importieren und zeigt vor dem Import eine Vorschau an.[1] Nutze für den ersten Test die in der offiziellen Anleitung angegebene Bewegungslicht-Vorlage:

https://github.com/home-assistant/core/blob/dev/homeassistant/components/automation/blueprints/motion_light.yaml

Die URL ist kein Platzhalter. Sie verweist auf den offiziellen, im Home-Assistant-Core gepflegten Beispiel-Blueprint. Seine aktuelle Datei beschränkt die Auswahl auf Bewegungs- beziehungsweise Anwesenheitssensoren und Lichter und verwendet eine einstellbare Wartezeit.[10]

Keine ungeprüften Vorlagen produktiv einsetzen

Eine fremde Vorlage kann Geräte schalten und andere Aktionen ausführen. Verwende beim ersten Test niemals Türschlösser, Garagentore, Herd, Bewässerung, Heizgeräte, Alarmfunktionen oder andere sicherheitsrelevante Ziele.

3. Offiziellen Blueprint importieren

Öffne Einstellungen → Automatisierungen & Szenen → Blueprints und wähle Blueprint importieren. Füge die URL aus Schritt 2 ein und öffne zuerst die Vorschau.[1]

Vergleiche in der Vorschau mindestens Name, Quelle, Eingaben und Aktionen mit deiner Erwartung. Importiere die Vorlage nur, wenn dort Motion-activated Light von Home Assistant erscheint und die Aktionen ausschließlich ein ausgewähltes Licht ein- und ausschalten.[10]

Nach dem Import erscheint der Blueprint in der Übersicht. Der Import allein erstellt noch keine laufende Automation; dazu wird im nächsten Schritt eine konkrete Anwendung mit deinen Eingaben angelegt.[1]

4. Erste Blueprint-Automation konfigurieren

Wähle beim Blueprint Automation erstellen und trage einen eindeutigen Namen ein, zum Beispiel:

Blueprint-Test: Bewegungslicht Flur

Wähle anschließend:

Motion Sensor: <mein_bewegungsmelder>
Light: <mein_testlicht>
Wait time: 120

Ersetze <mein_bewegungsmelder> über das Auswahlfeld durch einen echten Bewegungs- oder Anwesenheitssensor. Ersetze <mein_testlicht> durch ein unkritisches Licht. 120 ist die Abschaltverzögerung in Sekunden; für einen kurzen Test kannst du zunächst 10 wählen.

Speichere die Automation und kontrolliere noch einmal, dass kein falsches Gerät ausgewählt wurde. Der Blueprint bleibt die gemeinsame Logik, während diese Automation nur die konkreten Eingaben für diesen Raum speichert. Derselbe Blueprint kann später mit anderen Eingaben für weitere Räume verwendet werden.[1][2]

5. Funktion mit echter Bewegung prüfen

Aktiviere die neue Automation und löse den ausgewählten Bewegungsmelder aus. Das Testlicht muss eingeschaltet werden. Beende die Bewegung und warte die eingestellte Zeit ab; danach muss das Licht wieder ausgehen.[10]

Bewege dich während der Abschaltverzögerung erneut. Die offizielle Vorlage verwendet mode: restart, sodass der laufende Ablauf bei neuer Bewegung neu beginnt und das Licht nicht mitten in der erneuten Aktivität ausgeschaltet werden soll.[10]

Öffne anschließend die Automation und prüfe Spuren. Dort kontrollierst du, ob Bewegungsmelder und Licht im protokollierten Ablauf richtig zugeordnet sind. Aktionen ausführen ist kein vollständiger Bewegungsmeldertest: Die offizielle Vorlage wartet innerhalb ihrer Aktionen zusätzlich auf das Ende der Bewegung.[10]

Stelle nach dem Test eine sinnvolle Wartezeit ein. Sehr kurze Zeiten können zu häufigem Schalten führen; sehr lange Zeiten lassen das Licht unnötig eingeschaltet.

6. Eigenen einfachen Blueprint anlegen

Dieser Schritt ist optional und benötigt Zugriff auf den Home-Assistant-Konfigurationsordner. Erstelle dort die Datei:

/config/blueprints/automation/eigene/bewegungslicht_sicher.yaml

/config ist der Home-Assistant-Konfigurationsordner. eigene ist ein frei gewählter Unterordner für deine Vorlagen, und bewegungslicht_sicher.yaml ist der neue Dateiname. Automation-Blueprints liegen unter blueprints/automation; Home Assistant erlaubt dort eigene Unterordner.[3]

Füge diesen vollständigen Inhalt ein:

blueprint:
  name: Bewegungslicht mit Abschaltverzögerung
  description: >-
    Schaltet ein ausgewähltes Licht bei Bewegung ein und nach Ende der
    Bewegung mit einer einstellbaren Verzögerung wieder aus.
  domain: automation
  input:
    motion_entity:
      name: Bewegungs- oder Anwesenheitssensor
      selector:
        entity:
          filter:
            - domain: binary_sensor
              device_class: motion
            - domain: binary_sensor
              device_class: occupancy
    light_target:
      name: Ziellicht
      selector:
        target:
          entity:
            domain: light
    no_motion_wait:
      name: Abschaltverzögerung
      description: Sekunden nach dem Ende der Bewegung.
      default: 120
      selector:
        number:
          min: 0
          max: 3600
          unit_of_measurement: seconds

mode: restart
max_exceeded: silent

triggers:
  - trigger: state
    entity_id: !input motion_entity
    from: "off"
    to: "on"

actions:
  - action: light.turn_on
    target: !input light_target
  - wait_for_trigger:
      - trigger: state
        entity_id: !input motion_entity
        from: "on"
        to: "off"
  - delay: !input no_motion_wait
  - action: light.turn_off
    target: !input light_target

Der Abschnitt blueprint enthält Name, Beschreibung, Domäne und drei Eingaben. Selektoren begrenzen die Oberfläche auf passende Binärsensoren und Lichter; der Zahlenselektor erlaubt 0 bis 3600 Sekunden. Ein Blueprint benötigt mindestens name und domain, während Eingaben und Selektoren die wiederverwendbaren Werte definieren.[4]

!input motion_entity, !input light_target und !input no_motion_wait sind Blueprint-spezifische Verweise auf die Auswahl des Benutzers. Sie sind keine Jinja-Templates und dürfen nicht in {{ ... }} gesetzt werden. Die Trigger- und Aktionsstruktur sowie mode: restart orientieren sich an der aktuellen offiziellen Bewegungslicht-Vorlage.[3][10]

7. Eigenen Blueprint laden und testen

Speichere die Datei. Öffne anschließend Entwicklerwerkzeuge → YAML und lade die Automationen neu. Die offizielle Anleitung verlangt dieses Neuladen nach Änderungen an Blueprint-Dateien, damit Oberfläche und Automationsintegration den neuen Stand übernehmen.[2][3]

Gehe zurück zu Einstellungen → Automatisierungen & Szenen → Blueprints. Der Eintrag Bewegungslicht mit Abschaltverzögerung muss jetzt sichtbar sein. Wird stattdessen ein Fehler angezeigt, ändere noch keine bestehende Automation, sondern prüfe Dateipfad, Einrückung und die vollständige Fehlermeldung.

Erstelle mit dem eigenen Blueprint eine zweite Testautomation und verwende wieder nur den unkritischen Sensor und das Testlicht. Wiederhole die Funktionsprüfung aus Schritt 5 mit zehn Sekunden Wartezeit. Lösche nach erfolgreichem Test entweder die erste importierte Testautomation oder deaktiviere sie, damit nicht zwei Automationen dasselbe Licht gleichzeitig steuern.

8. Updates kontrolliert übernehmen

Automationen auf Blueprint-Basis übernehmen Änderungen an der zugrunde liegenden Vorlage beim nächsten Neuladen. Dadurch lassen sich mehrere Anwendungen zentral pflegen, aber eine fehlerhafte Änderung kann auch alle davon betreffen.[2]

Vor einem Re-Import:

  1. Erstelle ein neues Backup.
  2. Lies die Änderungen an der Quelle.
  3. Prüfe besonders neue Eingaben, Aktionen und Versionsanforderungen.
  4. Re-importiere den Blueprint über seine Quellanzeige und prüfe die Vorschau.
  5. Lade die Automationen neu und teste jede wichtige Anwendung erneut.[1][2]

Ändere eine importierte Datei nicht stillschweigend direkt, weil ein späterer Re-Import deine lokale Änderung ersetzen kann. Möchtest du eine einzelne Anwendung unabhängig weiterentwickeln, kannst du Kontrolle übernehmen wählen. Home Assistant wandelt sie dann in eine normale Automation um; zurück in eine Blueprint-Automation lässt sie sich nicht automatisch konvertieren.[1]

Zentrale Änderung, zentrale Wirkung

Aktualisiere gemeinsam verwendete Blueprints nicht ungeprüft. Deaktiviere im Zweifel zuerst die abhängigen Automationen und teste die neue Fassung mit ungefährlichen Geräten.

9. Typische Fehler beheben

  • Import schlägt fehl: Verwende die vollständige Quell-URL und prüfe, ob sie im Browser erreichbar ist. Home Assistant unterstützt für den Import insbesondere Forum, GitHub und GitHub-Gists.[1]
  • Blueprint erscheint nicht: Kontrolliere den Pfad unter /config/blueprints/automation/, die Dateiendung .yaml und lade die Automationen neu.[3]
  • YAML-Fehler: Verwende Leerzeichen statt Tabulatoren und prüfe die Einrückung unter input, selector, triggers und actions.
  • Sensor fehlt in der Auswahl: Er muss eine binary_sensor-Entität mit Geräteklasse motion oder occupancy bereitstellen.[10]
  • Licht fehlt in der Auswahl: Das Ziel muss als Entität der Domäne light vorhanden sein.[10]
  • Licht geht nicht aus: Prüfe, ob der Sensor nach der Bewegung wirklich von on auf off wechselt und ob die Wartezeit vollständig abgelaufen ist.
  • Licht geht zu früh aus: Vergrößere die Abschaltverzögerung und prüfe in den Spuren, ob der Sensor zwischendurch kurz off meldet.
  • Doppelte Schaltvorgänge: Deaktiviere ältere oder parallel angelegte Testautomationen für dasselbe Licht.
  • Fehler nach einem Update: Vergleiche die neue Blueprint-Datei mit der vorherigen Fassung, stelle bei Bedarf das Backup wieder her und teste erst danach erneut.

Die aktuelle Praxisquelle empfiehlt ebenfalls, Blueprints als Trennung von wiederverwendbarer Logik und konkreten Eingaben zu behandeln; für Feldnamen, Importweg und YAML-Syntax bleibt jedoch die offizielle Home-Assistant-Dokumentation maßgeblich.[3][9] Das öffentlich erreichbare Video Home Assistant Blueprints – Beginner's Guide zeigt Import, Verwendung und Erstellung anschaulich, stammt aber aus einer älteren Home-Assistant-Oberfläche. Nutze es deshalb nur für das Grundprinzip und folge für aktuelle Menünamen dieser Anleitung und der offiziellen Dokumentation.[1][8]

10. Rückweg durchführen

Deaktiviere zuerst jede mit dem betreffenden Blueprint erstellte Automation. Lösche anschließend nur die neuen Testautomationen. Entferne danach bei Bedarf den importierten Blueprint über die Blueprint-Verwaltung und lösche die eigene Datei:

/config/blueprints/automation/eigene/bewegungslicht_sicher.yaml

Lade die Automationen erneut und prüfe, dass keine Fehlermeldung wegen einer fehlenden Vorlage erscheint. Wenn du Kontrolle übernehmen verwendet hast, ist die umgewandelte Automation unabhängig vom Blueprint und muss separat deaktiviert oder gelöscht werden.[1]

Stelle das Backup aus Schritt 1 wieder her, falls du versehentlich bestehende Automationen oder Blueprint-Dateien verändert hast. Prüfe danach mit einem unkritischen Gerät, ob die vorherige Konfiguration wieder wie erwartet arbeitet.

Sources

[1] https://www.home-assistant.io/docs/automation/using_blueprints — Home Assistant: Using automation blueprints [2] https://www.home-assistant.io/docs/blueprint — Home Assistant: Blueprints [3] https://www.home-assistant.io/docs/blueprint/tutorial — Home Assistant: Tutorial create an automation blueprint [4] https://www.home-assistant.io/docs/blueprint/schema — Home Assistant: Blueprint schema [8] https://www.youtube.com/watch?v=XGScgnxjZTw — YouTube: Home Assistant Blueprints - Beginner's Guide [9] https://tecnoyfoto.com/en/home-assistant-blueprints-guide-2026 — Tecnoyfoto: Home Assistant Blueprints Guide 2026 [10] https://raw.githubusercontent.com/home-assistant/core/dev/homeassistant/components/automation/blueprints/motion_light.yaml — Home Assistant Core: Built-in motion light blueprint

Fertig

Du kannst jetzt einen Blueprint aus nachvollziehbarer Quelle vor dem Import prüfen, mit ungefährlichen Geräten testen, mehrfach verwenden und kontrolliert aktualisieren.[1][2] Die Funktionsprüfung ist bestanden, wenn Bewegung das gewählte Testlicht einschaltet, das Licht erst nach Bewegungsende und vollständiger Wartezeit ausgeht, erneute Bewegung die Abschaltung zurücksetzt und die Spur Trigger sowie Aktionen ohne Fehler zeigt.[10]