Instalace Home Assistant: průvodce krok za krokem

Průvodce instalací Home Assistant OS na mini PC nebo x86 počítač. Projdeme stažení obrazu, zápis na disk, první spuštění, onboarding, statickou IP, vzdálený přístup přes Cloudflare, zálohy a HACS.

Proč Home Assistant OS?

Existují čtyři způsoby instalace HA (HAOS, Supervised, Container, Core). Pro dedikovaný hardware doporučuji HAOS – spravuje addony přes Supervisor, automaticky aktualizuje systém a má vestavěný zálohovací systém. Je to nejjednodušší a nejspolehlivější varianta.

Co budeš potřebovat

• Mini PC nebo Raspberry Pi 4/5 – viz Jak začít s Home Assistant
• USB flash disk (min. 8 GB) pro zápis obrazu
• Ethernet kabel
• Zigbee USB koordinátor (pokud plánuješ Zigbee zařízení)

Stažení HAOS obrazu

Jdi na home-assistant.io/installation, vyber svůj hardware a stáhni aktuální obraz.

• x86-64 mini PC: haos_generic-x86-64-XX.X.img.xz
• Raspberry Pi 4: haos_rpi4-64-XX.X.img.xz
• Raspberry Pi 5: haos_rpi5-64-XX.X.img.xz

Zápis obrazu na SSD nebo USB

Stáhni a nainstaluj Balena Etcher. Pak:

1. Flash from file – vyber stažený obraz
2. Select target – vyber cílový disk (pozor na správný! Etcher smaže vše)
3. Flash – počkej 5-10 minut

Alternativa: Raspberry Pi Imager – jednodušší rozhraní, funguje i pro x86 image.

BIOS nastavení (mini PC)

Před prvním spuštěním nastav v BIOS/UEFI dvě věci:

• Boot order: SSD s HAOS jako první zařízení
• Auto Power On po výpadku proudu (Restore on AC Power Loss → Power On) – HA se pak automaticky spustí, i když vypadne a vrátí se proud

První spuštění

1. Zasuň SSD nebo USB s HAOS do PC, připoj ethernet a Zigbee dongle
2. Zapni PC – HAOS se nabootuje a automaticky nainstaluje na disk (cca 5 minut)
3. Otevři v prohlížeči http://homeassistant.local:8123

Pokud homeassistant.local nefunguje (záleží na OS a síti), zjisti IP zařízení z routeru nebo přes Advanced IP Scanner a přistup přes http://[IP_ADRESA]:8123.

Onboarding – první nastavení

Při prvním otevření tě HA provede průvodcem. Vyplň:

• Administrátorský účet – Owner účet má plná práva, tento krok nelze opakovat. Zapiš si heslo na bezpečné místo.
• Název domácnosti, jazyk: Čeština, časová zóna: Europe/Prague, jednotky: metrické
• Poloha: zadej přibližné město – HA ji používá pro automatizace závislé na poloze slunce (západ/východ, azimut)

Po dokončení HA prohledá síť a nabídne nalezená zařízení. Lze přeskočit a přidat kdykoliv.

Statická IP adresa

Nastav hned po onboardingu – jinak ti router může HA přiřadit jinou IP a ztratíš přístup.

Doporučuji: DHCP reservation v routeru podle MAC adresy HA serveru. Jednodušší a spolehlivější než nastavení přímo v HAOS.

Alternativa přímo v HAOS: Nastavení – Systém – Síť – klikni na Ethernet – přepni na Statická – zadej IP adresu/24, bránu a DNS – Uložit.

Vzdálený přístup přes Cloudflare Tunnel

Port forwarding na routeru nedoporučuji – zbytečně otevřeš port do internetu. Cloudflare Tunnel je bezpečnější: šifrovaný přístup odkudkoli, žádný otevřený port, zdarma.

Co potřebuješ: vlastní doménu (stačí .cz za ~50 Kč/rok) a bezplatný Cloudflare účet. DNS záznamy domény musí být spravovány přes Cloudflare.

Krok 1 – configuration.yaml

Do souboru /config/configuration.yaml přidej přímo v tomto souboru (ne ve vnořeném includovaném souboru):

http:
  use_x_forwarded_for: true
  trusted_proxies:
    - 172.30.33.0/24

Restartuj HA: Nastavení – Systém – Restartovat.

Krok 2 – vytvoření tunelu v Cloudflare

1. Přihlaš se na one.dash.cloudflare.com
2. Networks – Tunnels – Create a tunnel – Cloudflared
3. Pojmenuj tunel (např. homeassistant)
4. Zkopíruj vygenerovaný token

Krok 3 – instalace Cloudflared addonu

Nastavení – Doplňky – Obchod – tři tečky – Vlastní repozitáře – přidej:

https://github.com/homeassistant-apps/app-cloudflared

Nainstaluj Cloudflared. V záložce Konfigurace vlož token:

tunnel_token: SEM_VLOZ_SVUJ_TOKEN_Z_CLOUDFLARE

Krok 4 – veřejná hostname

V Cloudflare Zero Trust dashboardu: Networks – Tunnels – klikni na svůj tunel – Public Hostname – Add a public hostname:

• Subdoména: homeassistant, doména: tvojadomena.cz
• Service: HTTP, URL: localhost:8123

Krok 5 – spuštění a WebSockety

Záložka Informace – Spustit. V záložce Protokol sleduj zda se tunel připojí.

Pak v Cloudflare dashboardu: vyber svou doménu – Network – WebSockets – zapni. Bez WebSocketů budou problémy s live aktualizacemi stavů v HA rozhraní.

Ověř přístup z mobilní sítě (ne z domácí Wi-Fi): https://homeassistant.tvojadomena.cz. Po ověření nastav addonu Spustit při startu a Watchdog.

Zálohy na Google Drive

Automatické zálohy na Google Drive jsou záchrana při selhání hardware. Nastav hned.

1. Přidej repozitář: https://github.com/sabeechen/hassio-google-drive-backup
2. Nainstaluj Home Assistant Google Drive Backup
3. Po spuštění klikni Authenticate with Google Drive a autorizuj

Doporučená konfigurace v záložce Konfigurace addonu:

max_backups_in_ha: 3
max_backups_in_google_drive: 10
days_between_backups: 7
backup_time_of_day: "02:30"

HACS – komunitní obchod

HACS otevře přístup ke stovkám komunitních integrací a dashboard karet, které nejsou v oficiálním obchodě. Nainstaluj hned – dřív nebo později ho budeš potřebovat.

1. Nainstaluj addon Terminal & SSH z obchodu a spusť ho
2. Otevři terminál a spusť: wget -O - https://get.hacs.xyz | bash -
3. Restartuj HA: Nastavení – Systém – Restartovat
4. Nastavení – Zařízení a integrace – Přidat integraci – vyhledej HACS
5. Propoj s GitHub účtem (bezplatný) a autorizuj přístup

Co dál

Máš fungující Home Assistant s vzdáleným přístupem a zálohami. Dalším krokem je připojení Zigbee zařízení – viz návod Nastavení Zigbee2MQTT.

Pokud se někde zasekneš, napiš do kontaktu.