Scopul: un sistem actualizat, cu locația, unitățile și utilizatorii corecți înainte să adaugi orice dispozitiv.

1. Update complet: Settings → System → Updates. Actualizează Core, Supervisor și OS. Versiunea de referință pentru acest ghid este 2026.11.
2. Setări generale: Settings → System → General — nume, fus orar Europe/Bucharest, unități metrice, monedă RON, limbă română.
3. Zona Home: Settings → Areas, labels & zones → Zones; setează coordonatele exacte și raza.
4. Rețea: Settings → System → Network — adresă IP fixă (sau rezervare DHCP în router).
5. Arii și etaje: creează camerele de acum; vei asigna dispozitivele pe măsură ce le adaugi.
6. Utilizatori: un cont admin pentru tine, conturi non-admin pentru familie; activează „Advanced mode” din profil.
7. Aplicația mobilă Home Assistant (Android/iOS) — senzori de telefon, notificări, prezență.

Scopul: să editezi YAML din browser și să ai o consolă pentru ha CLI, fără să scoți cardul SD.

File editor

1. Settings → Apps (fost Add-ons) → Install app → File editor → Install.
2. Activează Start on boot și Show in sidebar.
3. Recomandat în opțiuni: enforce_basepath: true (vede doar /config) și git: true dacă versionezi configurația.
4. După orice modificare: Developer tools → YAML → Check configuration, apoi Reload sau Restart.

Terminal & SSH (oficial) sau Advanced SSH & Web Terminal (comunitar)

1. Install app → Terminal & SSH.
2. În Configuration adaugă cheia ta publică la authorized_keys și lasă password gol (vezi Etapa 3).
3. Folosește-l mai întâi doar prin terminalul web din sidebar; portul de rețea rămâne dezactivat până configurezi cheile.
4. Comenzi utile: ha core check, ha core restart, ha backups list, ha os info, ha supervisor logs.

A. SSH cu chei, fără parolă

1. Pe PC generează o cheie: ssh-keygen -t ed25519 -C "home-assistant".
2. Copiază conținutul ~/.ssh/id_ed25519.pub în Terminal & SSH → Configuration → authorized_keys; lasă password: "".
3. Network → setează portul SSH (ex. 22 sau 2222) doar pentru LAN și repornește app-ul.
4. Test din LAN: ssh root@homeassistant.local -p 22.
5. Accesul de debug la OS-ul gazdă (port 22222) doar dacă chiar ai nevoie — se configurează separat, prin stick USB CONFIG.

B. Acces din exterior la SSH — alege una

C. Acces web extern (HTTPS)

• Home Assistant Cloud (Nabu Casa) — cel mai simplu, fără porturi deschise; include și Google Assistant/Alexa (Etapele 8–9).
• Cloudflare Tunnel — domeniu propriu, fără porturi deschise; adaugă use_x_forwarded_for și trusted_proxies în secțiunea http:.
• Reverse proxy (NGINX Proxy Manager + Let’s Encrypt) — doar dacă știi să îl întreții.

D. Întărirea conturilor

• Autentificare în doi pași (TOTP) pe toate conturile admin: Profil → Security → Multi-factor authentication.
• ip_ban_enabled: true și login_attempts_threshold: 5 în http:.
• Parole unice; conturi non-admin pentru familie; „Can only log in from local network” unde e cazul.
• Tokenuri long-lived: câte unul per aplicație, cu nume clar, revocate când nu mai sunt folosite.

Scopul: backup zilnic, criptat, cu o copie în afara casei, și o restaurare testată măcar o dată. Integrarea oficială Google Drive înlocuiește vechiul add-on comunitar.

1. Credențiale Google (o singură dată)

1. Google Cloud Console → proiect nou → activează Google Drive API.
2. Google Auth Platform → Branding: nume aplicație, audiență External, domeniu autorizat home-assistant.io.
3. Audience → Publish app. În modul Testing credențialele expiră la 7 zile.
4. Clients → Web application, redirect URI: https://my.home-assistant.io/redirect/oauth.
5. Notează Client ID și Client Secret (secretul nu mai poate fi vizualizat ulterior). Activarea poate dura câteva ore.

2. Integrarea în Home Assistant

1. Settings → Devices & services → Add integration → Google Drive.
2. Introdu Client ID / Secret, autentifică-te cu contul Google, acceptă avertismentul „app not verified”.
3. HA creează în Drive folderul Home Assistant și are acces doar la fișierele create de el.

3. Programarea backup-ului

1. Settings → System → Backups → Set up backups.
2. Salvează cheia de criptare în managerul de parole și descarcă kit-ul de urgență. Fără ea, backup-ul nu poate fi restaurat pe altă instalare.
3. Program: zilnic, la o oră liniștită (ex. 04:45).
4. Locații: This system + Google Drive. Opțional, din 2026.11: un disc local USB (Settings → System → Storage → Add storage → Local disk).
5. Retenție: ultimele 7–14 copii.
6. Conținut: setarea completă + apps + baza de date istorică (sau fără istoric, dacă baza e mare).

4. Verificare

• Rulează manual un backup și verifică fișierul .tar în Drive.
• Creează o automatizare care te notifică dacă senzorul „last successful automatic backup” e mai vechi de 2 zile.
• Test de restaurare: o instalare nouă (VM sau alt card) → la onboarding alege Restore from backup.

Pe 2026.11 sau mai nou (recomandat)

1. Settings → Marketplace (între Apps și Dashboards).
2. La prima deschidere accepți avertismentul: proiectele comunitare nu sunt testate sau suportate oficial.
3. Caută extensia (ex. Tuya Local) → Install → te duce direct în fluxul de configurare, fără restart. Update-urile cer încă un restart.
4. Cardurile și temele apar după un reload al browserului.
5. Contul GitHub e necesar doar pentru repository-uri custom („Add from link”), prin device login.
6. Lasă Download source pe GitHub, sursa implicită.

Ai HACS dinainte?

La primul start după update, HACS migrează automat în Marketplace, cu tot cu extensiile și repository-urile custom. Înlocuiește integration_entities('hacs') cu integration_entities('marketplace') în template-uri.

Versiuni mai vechi de 2026.11

Instalezi HACS cu app-ul Get HACS sau din Terminal cu wget -O - https://get.hacs.xyz | bash -, restart, apoi Add integration → HACS și autorizare GitHub.

ZHA e integrarea Zigbee nativă: nu cere broker MQTT și rulează 100% local. Alternativa este Zigbee2MQTT, mai flexibilă, dar cu mai multe componente.

Instalare

1. Conectează coordonatorul pe un cablu prelungitor USB 2.0 (0,5–1 m), departe de porturi USB 3.0, SSD și router WiFi.
2. De obicei HA îl descoperă singur: Settings → Devices & services → Discovered → ZHA → Configure. Altfel: Add integration → Zigbee Home Automation → alege portul serial (/dev/serial/by-id/...).
3. Alege Create a network. Pentru coordonatoare de rețea (ex. SLZB-06), introdu socket://IP:6638.
4. Actualizează firmware-ul coordonatorului dacă HA îl propune (ZBT-1/ZBT-2 au update direct din HA).

Adăugarea dispozitivelor

1. ZHA → Add device, apoi pune dispozitivul în pairing (de obicei, buton ținut 5 s).
2. Asociază-l pe loc unei arii și redenumește-l clar (ex. Senzor ușă hol).
3. Începe cu dispozitivele alimentate la rețea (prize, relee, becuri) — sunt routere și extind rețeaua mesh. Abia apoi adaugă senzorii pe baterie, aproape de locul lor final.

Bune practici Zigbee

• Canal Zigbee 15, 20 sau 25 — suprapunere minimă cu WiFi 2.4 GHz pe canalele 1/6/11.
• Minimum un router la 2–3 camere; evită becurile smart deconectate de la întrerupător.
• Vizualizează rețeaua: ZHA → Configure → Visualization.
• Rețeaua Zigbee e inclusă în backup-ul HA; poți migra pe alt coordonator fără re-pairing (ZHA → Migrate radio).
• Dispozitivele Tuya Zigbee cu funcții lipsă pot avea nevoie de quirks (ZHA Device Handlers).

Pentru dispozitivele Tuya WiFi, folosește integrarea oficială ca să ai rapid totul în HA, apoi mută pe Tuya Local ce trebuie să meargă și fără internet. Dispozitivele Tuya Zigbee merg mai bine direct în ZHA (Etapa 6), fără gateway Tuya.

A. Integrarea oficială Tuya

1. Adaugă dispozitivele în aplicația Smart Life sau Tuya Smart.
2. În aplicație: Me → Settings → Account and Security → copiază User code.
3. HA: Add integration → Tuya → introdu User code → scanează codul QR cu aplicația Smart Life.
4. Nu mai ai nevoie de cont de dezvoltator Tuya IoT pentru integrarea oficială.

B. Tuya Local (make-all/tuya-local)

1. Marketplace → caută Tuya Local → Install.
2. Add integration → Tuya Local. Cea mai simplă cale: autentificare prin Smart Life cloud assisted, care preia automat Device ID și Local Key.
3. Alternativ, manual: Device ID și Local Key din Tuya IoT Platform sau cu utilitarul tinytuya wizard, plus IP-ul dispozitivului.
4. Rezervă IP fix în router pentru fiecare dispozitiv.
5. După ce dispozitivul merge local, dezactivează-l din integrarea Tuya cloud ca să nu ai entități duble.

Ai trei căi; pentru majoritatea instalațiilor, Nabu Casa este cea mai simplă. Comenzile vocale se dau în engleză, fiindcă Google Assistant nu suportă limba română.

A. Prin Nabu Casa

1. Settings → Home Assistant Cloud → autentificare → activează Google Assistant.
2. Settings → Voice assistants → Expose: alege explicit entitățile vizibile pentru Google. Nu expune totul.
3. Aplicația Google Home → + → Works with Google → Home Assistant Cloud by Nabu Casa → login.
4. Atribuie camerele în Google Home sau lasă sincronizarea ariilor din HA.
5. Pentru uși, lacăte și alarme, setează un PIN de securitate.

B. Manual (fără abonament)

Necesită acces HTTPS extern funcțional (Etapa 3), un proiect în Google Home Developer Console, account linking OAuth și blocul google_assistant: în configuration.yaml. Urmează exact pașii din documentația oficială; interfața Google se schimbă des.

C. Bridge Matter

Un app care expune entitățile HA ca dispozitive Matter (ex. Home-Assistant-Matter-Hub), adăugat în Google Home ca dispozitiv Matter. Merge local, dar suportă doar tipurile de dispozitive Matter. Verifică starea proiectului înainte.

Două direcții diferite: Alexa controlează HA (comenzi vocale către dispozitivele tale) și HA controlează Alexa (anunțuri TTS, rutine, volum pe Echo). Alexa nu are limba română; contul Amazon trebuie să fie pe o regiune suportată (de obicei amazon.de sau amazon.com).

A. Alexa controlează HA — prin Nabu Casa (recomandat)

1. Settings → Home Assistant Cloud → activează Alexa.
2. Settings → Voice assistants → Expose → alege entitățile pentru Alexa.
3. Aplicația Alexa → Skills → Home Assistant (by Nabu Casa) → Enable → login.
4. „Alexa, discover devices”; grupează dispozitivele pe camere în aplicația Alexa.

B. Manual, fără abonament

Skill Smart Home propriu în Alexa Developer Console + funcție AWS Lambda + acces HTTPS extern + blocul alexa: smart_home: în YAML. Gratuit, dar laborios. Alternativ, un bridge Matter către un Echo cu suport Matter (ca la Etapa 8, varianta C).

C. HA controlează Alexa — Alexa Media Player (Marketplace)

1. Marketplace → Alexa Media Player → Install.
2. Add integration → Alexa Media Player → email, parolă, domeniu Amazon și cheia 2FA (Built-in authenticator app key din contul Amazon).
3. Folosește notify.alexa_media_<nume_echo> pentru anunțuri și entitățile media_player pentru volum și redare.
4. Autentificarea expiră periodic: creează o automatizare care te anunță când integrarea cere relogare.

Cu un server MCP (Model Context Protocol), Claude poate citi stări, crea automatizări, scripturi și dashboard-uri, analiza loguri și trace-uri — direct în Home Assistant, din conversație.

Instalare ha-mcp (HA 2026.8+)

1. Creează un utilizator dedicat, ex. claude-mcp (admin, dacă vrei editare). Modificările vor apărea în istoric sub acest nume, nu sub al tău.
2. Marketplace → caută HA-MCP → Install.
3. Settings → Devices & services → Add integration → HA-MCP Server → autentificare cu utilizatorul dedicat.
4. Alege modul de acces: Local only (implicit) sau acces remote prin Secret URL (opțional cu ha_auth).
5. Copiază URL-ul de conectare din Configure al integrării.
6. Variante alternative: app-ul Home Assistant MCP Server (repository https://github.com/homeassistant-ai/ha-mcp în Settings → Apps → Repositories), Docker sau uvx ha-mcp@latest. Folosește una singură.

Conectarea la Claude

• Claude Desktop / Cowork: Settings → Connectors → Add custom connector → lipește URL-ul MCP. Asistentul de configurare ha-mcp generează configurația exactă pentru fiecare client.
• Claude.ai (web/mobil): necesită URL accesibil din internet (Nabu Casa, Cloudflare Tunnel sau reverse proxy din Etapa 3).
• Claude Code: claude mcp add cu URL-ul HTTP al serverului.

Exemple de prompturi

• „Arată-mi toate entitățile unavailable și grupează-le pe integrare.”
• „Creează o automatizare: dacă senzorul de ușă de la hol stă deschis peste 5 minute, trimite notificare pe telefonul meu.”
• „De ce nu a rulat aseară automatizarea X? Verifică trace-ul.”
• „Fă un dashboard pentru sufragerie cu lumini, temperatură și prize.”

Siguranță

• Utilizator dedicat, nu tokenul tău personal.
• Pentru început, URL-ul /readonly sau Read Only Mode.
• Secret URL-ul e o parolă: nu-l publica; activează ha_auth pentru acces remote.
• Cere-i lui Claude să îți arate YAML-ul înainte să salveze; ha-mcp face backup automat înaintea editării automatizărilor.
• Uneltele de editare fișiere/YAML sunt beta și oprite implicit — lasă-le așa.

Organizare

• Convenție de nume: <cameră>_<tip>_<detaliu> pentru entități (ex. light.hol_tavan), nume prietenoase în română.
• Folosește etaje, arii și etichete (labels) — asistenții vocali și dashboard-urile le preiau automat.
• Automatizările grupate pe categorii, cu o descriere scurtă la fiecare.

Stabilitate

• Update-uri: așteaptă versiunea .1 sau .2 a fiecărei lansări lunare și citește secțiunea Backward-incompatible changes.
• Backup înainte de orice update (bifează opțiunea de backup în fereastra de update).
• Hardware: SSD în loc de card SD; un UPS mic pentru router + HA.
• Recorder: purge_keep_days: 10 și exclude entitățile zgomotoase (ex. senzori de semnal), ca baza de date să rămână mică.

Automatizări robuste

• Folosește Blueprints pentru tipare repetate (senzor de mișcare → lumină).
• Condiții pe unavailable/unknown, ca să nu se declanșeze la repornire.
• Mod restart sau queued setat conștient pe automatizările cu întârzieri.
• Verifică Traces când ceva nu merge, înainte să modifici.
• Preferă controlul local: Zigbee, Matter, Tuya Local; cloudul doar unde nu există alternativă.

Securitate continuă

• Verifică lunar Settings → Repairs și Settings → System → Logs.
• Revizuiește tokenurile long-lived și utilizatorii o dată pe trimestru.
• Rețea separată (VLAN sau rețea de oaspeți) pentru dispozitivele IoT WiFi, dacă routerul permite.

Monitorizare

• Integrarea System Monitor (CPU, RAM, disc) + notificare când discul trece de 80%.
• Alertă pentru baterii sub 20% (există blueprint-uri gata făcute).
• Energy dashboard configurat cu prizele inteligente și contorul general.