Was wir aus deinem Home Assistant brauchen

Zuerst alle Geräte einem Raum zuordnen

Ordne vor dem Export jedes Gerät in Home Assistant einem Bereich zu. Ein „Bereich“ ist dort ein Raum. Das ist der einfachste Schritt, mit dem du die Vorbereitung deines Dashboards beschleunigen kannst.

Wenn du Bereiche und Etagen eingerichtet hast, kommen diese Angaben mit in den Export. Ohne Bereiche enthält die Datei keine Raumzuordnung. Dann müssen wir die Räume gemeinsam mit dir klären.

Deine Zugangsdaten bleiben bei dir

Wir brauchen von dir weder ein Passwort noch einen Zugangsschlüssel. Der vorgesehene Export enthält keine Passwörter und keine Aufzeichnung darüber, was jemand zu Hause gemacht hat.

Sende uns niemals eine vollständige Home-Assistant-Sicherung, secrets.yaml, core.auth, Dateien namens auth_provider.*, die Recorder-Datenbank, Standortverläufe oder Kameraaufnahmen. Auch Zugangstoken und API-Schlüssel gehören nicht in die Anfrage. Solche Dateien und Zugangsdaten nehmen wir nicht an.

So erstellst du die Geräteliste

Am besten geht das am Computer. Du brauchst keine Programmierkenntnisse, keinen Zugriff auf die Home-Assistant-Dateien und kein Add-on. Für diese Schritte meldest du dich selbst in deinem Home Assistant an. Deine Zugangsdaten gibst du uns dabei nicht weiter. Beim Export verlässt nur der Text dein Zuhause, den du selbst kopierst und an uns sendest.

1. Öffne Home Assistant im Browser und melde dich als Administrator an.
2. Öffne Einstellungen, scrolle ganz nach unten und wähle Werkzeuge, dann den Reiter Template. Schneller: Drücke Strg+K (Cmd+K am Mac), tippe template ein und drücke Enter.
3. Leere das linke Eingabefeld.
4. Füge die unten bereitgestellte Exportvorlage unverändert ein.

{#- Device list for your 3D dashboard. The result is one long line of text.
    In Home Assistant, open Settings → Tools → Template (or press Ctrl+K / Cmd+K and type
    "template"). Clear the box on the left and paste all of this text into it. Copy the line
    that appears on the right and save it as ha-inventory.json.
    It lists your floors and rooms, and for each device its name, room and what it can do.
    It needs no password and no access key, and the result contains no history and no
    measured values or on/off states. -#}
{%- set d = namespace(floors=[], areas=[], entities=[]) -%}
{%- for f in floors() -%}
  {%- set d.floors = d.floors + [{'id': f, 'name': floor_name(f), 'areas': floor_areas(f)}] -%}
{%- endfor -%}
{%- for a in areas() -%}
  {%- set d.areas = d.areas + [{'id': a, 'name': area_name(a)}] -%}
{%- endfor -%}
{%- for s in states -%}
  {%- if s.domain in ['light', 'cover', 'binary_sensor', 'sensor', 'switch', 'climate', 'weather'] -%}
    {%- set d.entities = d.entities + [{
      'id': s.entity_id, 'name': s.name, 'domain': s.domain,
      'area': area_id(s.entity_id),
      'device_class': state_attr(s.entity_id, 'device_class'),
      'unit': state_attr(s.entity_id, 'unit_of_measurement'),
      'supported_features': state_attr(s.entity_id, 'supported_features'),
      'color_modes': state_attr(s.entity_id, 'supported_color_modes'),
      'min_kelvin': state_attr(s.entity_id, 'min_color_temp_kelvin'),
      'max_kelvin': state_attr(s.entity_id, 'max_color_temp_kelvin'),
      'hidden': is_hidden_entity(s.entity_id),
      'temperature_attribute': 'current_temperature' if s.domain == 'climate' and state_attr(s.entity_id, 'current_temperature') is not none else none
    }] -%}
  {%- endif -%}
{%- endfor -%}
{#- instance and ha_version cannot be read from a template; the operator fills them in. The date
    only, not the time: HA re-renders a template that reads the clock every minute, and the text
    would never stop changing while the customer copies it. -#}
{{ {'version': 1,
    'source': {'kind': 'template-export', 'instance': none, 'captured': utcnow().date().isoformat(), 'ha_version': none},
    'floors': d.floors, 'areas': d.areas, 'entities': d.entities} | to_json }}

5. Rechts erscheint eine lange Textzeile. Warte, bis sich der Text nicht mehr verändert. Bei vielen Geräten kann das einige Sekunden dauern.
6. Klicke in das rechte Feld. Wähle den gesamten Text mit Strg+A / Cmd+A aus und kopiere ihn mit Strg+C / Cmd+C.
7. Füge den Text in eine leere Nur-Text-Datei ein und speichere sie als ha-inventory.json. Achte darauf, dass der Name nicht auf .json.txt endet. Lade diese eine Datei bei deiner Anfrage unter „Geräteliste aus Home Assistant / KNX-Datei“ hoch.

Was du wo hinzufügst

• Geräteliste aus Home Assistant / KNX-Datei: eine Datei ha-inventory.json. Wenn dein Zuhause KNX nutzt und du eine knx.yaml hast, sende stattdessen diese. Sie enthält zusätzlich die Gruppenadressen. Sende in diesem Feld nur eine Datei.
• 3D-Scan oder Grundriss mit Maßen: die Unterlagen für das Hausmodell. Bei einem Grundriss kannst du eine Bilddatei verwenden. Falls dein Format nicht zur angezeigten Dateiliste passt, erwähne es in deiner Anfrage. Wir klären die Übergabe mit dir.
• Außenfotos: empfohlene Ansichten von außen. Sie helfen beim Modell, sind aber keine Voraussetzung.

Für die erste Anfrage genügen deine E-Mail-Adresse und dein Smart-Home-System. Du kannst die Unterlagen später ergänzen. Wir bestätigen den Start erst, wenn Umfang, nötige Unterlagen und Anbindung geklärt sind.

Wenn etwas nicht klappt

• „Ich finde die Werkzeuge nicht.“ Die Werkzeuge gibt es nur für Administrator-Konten. In Home-Assistant-Versionen vor 2026.2 heißen sie „Entwicklerwerkzeuge“ und stehen in der Seitenleiste statt unter Einstellungen. Wenn du in dieser Installation kein Administrator bist, bitte die Person, der die Installation gehört, den Export zu erstellen.
• Rechts steht ein roter Fehler. Mache einen Screenshot und erwähne den Fehler in deiner Anfrage. Wir klären mit dir, wie du uns das Bild senden kannst.
• Der Text wirkt abgeschnitten. Sag uns das in deiner Anfrage. Wir helfen dir mit einem anderen Weg.
• „Das fühlt sich falsch an.“ Hör auf. Mache stattdessen einen Screenshot von Einstellungen → Geräte & Dienste → Entitäten. Sag uns in deiner Anfrage, dass du diesen Weg nutzen möchtest. Wir klären die Bildübergabe mit dir. Die Zuordnung dauert für uns länger, ist damit aber möglich.

Prüfe Screenshots vor dem Senden auf private Angaben und Zugangsdaten. Sende nur den nötigen Ausschnitt. Das technische Uploadfeld nimmt keine Bilddateien an.