Vilém Vrbický Zpět na výpis článků
FB tw

Jak nainstalovat HACS do Home Assistant

Home Assistant je bezpochyby jednou z nejvyspělejších open-source platforem pro chytrou domácnost. Přestože již v základu nabízí stovky oficiálních integrací pro světla, vypínače, senzory, klimatizace či multimédia, to pravé kouzlo a neomezené možnosti přizpůsobení přicházejí s HACS (Home Assistant Community Store).

HACS je komunitní „aplikační obchod“ a správce rozšíření, který vám umožní pohodlně vyhledávat, stahovat a jedním kliknutím aktualizovat tisíce doplňků od tvůrců z celého světa – od speciálních ovladačů pro hardware (Tuya Local, Sonoff LAN, střídače fotovoltaiky, české meteo integrace) až po špičkové grafické karty a motivy pro váš ovládací panel (Lovelace Dashboard).

V tomto návodu si krok za krokem ukážeme, jak HACS do vašeho Home Assistantu stáhnout (ať už v přívětivém grafickém rozhraní bez terminálu, nebo přes příkazovou řádku), jak jej propojit s GitHubem a začít naplno využívat.

Pokud s platformou Home Assistant teprve začínáte nebo vybíráte hardware, inspirujte se v naší rubrice Chytrá domácnost na Drátek.cz.

Co budeme k instalaci potřebovat?

  • Běžící instalaci Home Assistant (ideálně Home Assistant OS na Raspberry Pi, mini PC, tenkém klientu nebo virtuálním serveru).
  • Účet na službě GitHub – registrace je zcela bezplatná a slouží k bezpečnému přístupu ke komunitním repozitářům bez narážení na stahovací limity (rate limits).

Krok 1: Stažení HACS (Vyberte si jeden ze 2 způsobů)

HACS můžete do Home Assistantu stáhnout dvěma způsoby. Pro většinu uživatelů je nejsnazší Způsob A, který nevyžaduje otevírání terminálu.

Způsob A: Instalace přes doplněk „Get HACS“ (Nejjednodušší – bez terminálu)

Pokud používáte Home Assistant OS nebo Supervised, můžete HACS stáhnout přímo přes rozhraní doplňků:

  1. V levém menu klikněte na Nastavení → Aplikace.
  2. Vpravo dole klikněte na Nainstalovat aplikaci.
  3. V pravém horním rohu klikněte na tři tečky → Úložiště.
  4. V pravém dolním rohu klikněte na Přidat, do pole vložte adresu oficiálního repozitáře: 
    https://github.com/hacs/addons
    a klikněte na Přidat (Add).

    Přidání HACS repozitáře

  5. Zavřete okno úložiště. V seznamu aplikací vyhledejte novou aplikaci HACS s doplňkem Get HACS (pokud se nezobrazí ihned, obnovte stránku klávesou F5).
  6. Klikněte na Get HACS, zvolte Instalovat (Install) a poté Spustit (Start).

    Instalace a spuštění doplňku Get HACS

Doplněk automaticky stáhne a připraví všechny potřebné soubory HACS do systémové složky a sám se ukončí.

Způsob B: Stažení přes terminál / SSH (Pro pokročilé, Container i Core)

Pokud preferujete práci v příkazové řádce nebo provozujete Home Assistant v Docker kontejneru (Container / Core):

  1. Nainstalujte a spusťte oficiální doplněk Terminal & SSH z Obchodu s doplňky.
  2. V terminálu zadejte instalační příkaz a stiskněte Enter: 
    wget -O - https://get.hacs.xyz | bash -

Během několika sekund se soubory stáhnou a v terminálu se zobrazí potvrzení Installation complete.

Krok 2: Restartování Home Assistantu

Aby jádro Home Assistantu novou staženou komponentu zaregistrovalo, je nutné celý systém restartovat:

  1. Přejděte do Nastavení (Settings) → Systém (System).
  2. Vpravo nahoře klikněte na ikonu restartu / napájení.
  3. Zvolte Restartovat Home Assistant (Restart Home Assistant) a vyčkejte přibližně 1 až 2 minuty, než systém znovu naběhne.

Krok 3: Přidání integrace HACS do systému

Po restartu je HACS fyzicky přítomen v souborovém systému. Nyní jej aktivujeme jako standardní integraci:

  1. V menu otevřete Nastavení (Settings) → Zařízení a služby (Devices & Services).
  2. Vpravo dole klikněte na modré tlačítko Přidat integraci (Add Integration).
  3. Do vyhledávacího pole napište HACS a klikněte na nalezenou položku.

Zobrazí se dialogové okno s podmínkami užívání (upozornění, že HACS obsahuje neoficiální komunitní doplňky). Zaškrtněte všechna pole a potvrďte tlačítkem Odeslat (Submit).

Krok 4: Autorizace a propojení s GitHub účtem

  1. Home Assistant vám vygeneruje 8místný autorizační kód (např. ABCD-1234) a nabídne přímý odkaz na adresu https://github.com/login/device.

  1. Kód si zkopírujte, otevřete odkaz na GitHub a vložte jej do připraveného formuláře.
  2. Potvrďte autorizaci kliknutím na zelené tlačítko Continue.
  3. Vraťte se do okna Home Assistantu – systém automaticky potvrdí úspěšné spárování. Klikněte na Dokončit (Finish).

V levém navigačním panelu se vám nyní objeví nová záložka HACS.

Co všechno v HACS najdete a jak jej používat?

HACS rozděluje komunitní doplňky do dvou základních kategorií:

KategoriePříklady oblíbených doplňkůK čemu slouží
Integrace (Integrations) Tuya Local, Sonoff LAN, Solarman (FVE), ČHMÚ počasí, Alza / Zásilkovna tracker, GoodWe Přímé propojení s hardwarem, cloudovými i lokálními službami bez omezení.
Uživatelské rozhraní (Frontend / Lovelace) Mushroom Cards, Mini Media Player, ApexCharts Card, Bubble Card, Card-Mod Moderní ovládací prvky, interaktivní grafy, animace a kompletní grafická témata.

Jak přidat vlastní (nezařazený) repozitář z GitHubu?

Pokud na GitHubu objevíte zajímavý doplněk, který ještě není v oficiálním HACS katalogu, můžete jej přidat ručně:

  1. Otevřete HACS.
  2. V pravém horním rohu klikněte na tři tečky → Vlastní repozitáře (Custom repositories).
  3. Vložte URL adresu projektu na GitHubu (např. https://github.com/autor/projekt).
  4. Vyberte typ doplňku (Integration nebo Dashboard) a klikněte na Přidat (Add).

Závěr

Instalace HACS je základním stavebním kamenem každé moderní chytré domácnosti postavené na Home Assistantu. Otevírá vám cestu ke stovkám propracovaných karet, lokálnímu řízení bez cloudu a nekonečným možnostem vizualizace vašich senzorů a měření.

Vyzkoušejte propojit Home Assistant například s našimi bezdrátovými moduly a senzory na Drátek.cz!

FB tw

Další podobné články