Inštalácia a nastavenie KVM/QEMU s virt-manager pre Home Assistant OS na Debiane

Chcete spustiť Home Assistant OS na Debiane vo virtuálnom stroji? Použitie KVM/QEMU s grafickým nástrojom virt-manager je skvelý spôsob, ako dosiahnuť vysoký výkon a natívnu integráciu s Debianom. Tento návod vás prevedie krok za krokom inštaláciou KVM/QEMU, virt-manager a nastavením Home Assistant OS na notebooku s Debianom. Je napísaný tak, aby bol jednoduchý, no pokrýval všetky potrebné kroky pre začiatočníkov aj pokročilých používateľov.

Predpoklady

Debian 11 alebo 12 (Bookworm odporúčaný) nainštalovaný a aktualizovaný.
Používateľ s právami sudo.
CPU s podporou virtualizácie (VT-x/AMD-V). Skontrolujte príkazom: egrep -c '(vmx|svm)' /proc/cpuinfo (výstup > 0 znamená podporu).
Minimálne 4 GB RAM (odporúča sa 8 GB) a 32 GB voľného úložiska.

Krok 1: Inštalácia KVM/QEMU a virt-manager

KVM je natívny hypervízor v Linuxovom jadre a QEMU ho dopĺňa emuláciou. Virt-manager poskytuje grafické rozhranie na správu virtuálnych strojov.

1. Aktualizujte systém:

sudo apt update
sudo apt full-upgrade

1. Nainštalujte potrebné balíčky:

sudo apt install -y qemu-kvm libvirt-daemon-system libvirt-clients virt-manager virtinst bridge-utils

Tento príkaz nainštaluje KVM, QEMU, libvirt (správca virtualizácie) a virt-manager (GUI).

1. Povolte a spustite libvirt démon:

sudo systemctl enable --now libvirtd

1. Pridajte používateľa do skupiny libvirt:

Tým zaistíte, že váš používateľ môže spravovať virtuálne stroje bez root práv:

sudo usermod -aG libvirt tvoj_pouzivatel

Nahraďte tvoj_pouzivatel vaším menom používateľa (zistite príkazom whoami).

1. Skontrolujte inštaláciu:

Overte, či KVM funguje:

virsh list --all

Ak príkaz vráti prázdny zoznam bez chyby, KVM je funkčný.

Krok 2: Stiahnite Home Assistant OS

Home Assistant OS poskytuje obrazy vo formáte QCOW2, ktoré sú ideálne pre KVM.

1. Navštívte oficiálnu stránku Home Assistant a stiahnite QCOW2 obraz pre KVM (napr. haos_ova-x.x.x.qcow2).
2. Presuňte obraz do vhodného priečinka, napr.:

mkdir ~/haos
mv ~/Downloads/haos_ova-x.x.x.qcow2 ~/haos/

Krok 3: Nastavenie sieťového mostu (Bridge)

Aby bol Home Assistant dostupný z lokálnej siete (napr. na http://IP_adresa:8123), nastavte sieťový most:

1. Nainštalujte bridge-utils (ak ešte nie sú nainštalované):

sudo apt install bridge-utils

1. Upravte sieťovú konfiguráciu:

Upravte súbor /etc/network/interfaces alebo použite NetworkManager. Príklad pre /etc/network/interfaces:

sudo nano /etc/network/interfaces

Pridajte:

auto br0
iface br0 inet dhcp
    bridge_ports enp0s3
    bridge_stp off
    bridge_fd 0
    bridge_maxwait 0

Nahraďte enp0s3 názvom vášho sieťového rozhrania (zistite príkazom ip link).

1. Reštartujte sieť:

sudo systemctl restart networking

Ak používate NetworkManager, nastavte most cez nm-connection-editor alebo CLI nástroj nmcli.

Krok 4: Vytvorenie virtuálneho stroja v virt-manager

1. Spustite virt-manager:

Otvorte virt-manager z menu alebo príkazom:

virt-manager

1. Vytvorte nový virtuálny stroj:
  - Kliknite na File > New Virtual Machine.
  - Vyberte Import existing disk image.
  - Vyberte stiahnutý QCOW2 obraz (napr. ~/haos/haos_ova-x.x.x.qcow2).
  - Nastavte operačný systém na Generic alebo Other Linux.
2. Nastavte hardvér:
  - CPU: Min. 2 jadrá (odporúča sa 4, ak je k dispozícii).
  - RAM: Min. 2 GB (odporúča sa 4 GB).
  - Úložisko: Použite existujúci QCOW2 obraz (min. 32 GB).
  - Sieť: Vyberte Bridge device a nastavte br0 (vytvorený most).
3. Spustite VM:

Po vytvorení kliknite na Finish a spustite virtuálny stroj.

Krok 5: Spustenie a prístup k Home Assistant

Home Assistant OS sa automaticky nainštaluje a spustí vo virtuálnom stroji.
Zistite IP adresu virtuálneho stroja:
- V konzole VM (prístupnej cez virt-manager) spustite ip addr.
- IP adresa bude priradená mostom (br0).
V prehliadači otvorte http://IP_adresa:8123 (napr. http://192.168.1.100:8123).
Postupujte podľa sprievodcu na nastavenie administrátorského konta a základnej konfigurácie.

Krok 6: Nastavenie firewallu

Ak používate firewall (ufw), povoľte port 8123 pre prístup k Home Assistant:

sudo ufw allow 8123

Skontrolujte, či je sieťový most povolený:

sudo ufw allow from 192.168.1.0/24 to any port 8123

Nahraďte 192.168.1.0/24 rozsahom vašej lokálnej siete.

Krok 7: Zdieľanie súborov (voliteľné)

Ak chcete zdieľať súbory z Debianu s Home Assistant, nainštalujte Samba doplnok v HA OS:

V HA OS otvorte webové rozhranie a prejdite na Settings > Add-ons > Add-on Store.
Nainštalujte doplnok Samba Share.
Nastavte priečinok v Debiane (napr. /home/tvoj_pouzivatel/zdielane) a zdieľajte ho cez Samba v Debiane (návod na konfiguráciu Samby nájdete v predchádzajúcich článkoch).

Alternatívne môžete súbory zdieľať priamo v Debiane cez Sambu alebo FTP a pristupovať k nim z HA OS cez sieť.

Tipy na správu

Zálohy: Vytvárajte pravidelné zálohy cez webové rozhranie HA OS (Settings > System > Backups). Ukladajte ich na zdieľaný priečinok v Debiane.
Snapshoty: V virt-manager vytvárajte snapshoty VM pred väčšími zmenami (Virtual Machine > Manage Snapshots).
Výkon: Ak je notebook pomalší, znížte pridelenú RAM na 2 GB a obmedzte počet CPU jadier na 2.
Sieť: Ak máte problémy s prístupom, skontrolujte nastavenie mostu príkazom brctl show.

Riešenie problémov

VM sa nespúšťa: Skontrolujte, či je virtualizácia povolená v BIOSe (VT-x/AMD-V). Overte príkazom kvm-ok (nainštalujte cpu-checker).
Chýbajúce závislosti: Ak sa objavia chyby, opravte ich príkazom sudo apt --fix-broken install.
Problémy so sieťou: Skontrolujte, či je most (br0) funkčný: ip link show br0. Ak nefunguje, prekonfigurujte sieť cez NetworkManager.
Logy: Skontrolujte logy VM cez virt-manager alebo príkazom virsh console nazov_vm.

Záver

Inštalácia Home Assistant OS na KVM/QEMU s virt-manager na Debiane je výkonná a flexibilná voľba, ktorá zachováva váš Debian a poskytuje takmer natívny výkon virtuálneho stroja. Tento postup je ideálny, ak chcete kombinovať Home Assistant s inými službami na Debiane (napr. Samba na zdieľanie súborov).