felhom.eu/documentation/pilot/GUIDE-omv-kvm-hu.md

Felhom virtuális gépben, OpenMediaVault 8 alatt — útmutató

Készült 2026-10-15-én, egy pontos másolaton kipróbálva (OMV 8.5.11-1, 7.2.6-os kernel, KVM bővítmény 8.3.4, Felhom telepítő 1.29.0). A próba jegyzőkönyve: documentation/audits/omv-vm-2026-10-15/README.md.

Röviden (ezt lehet e-mailben elküldeni)

1. Tedd be a 16 GB memóriát, kapcsold be a BIOS-ban a virtualizációt (Intel VT-x), és mentsd le a filmeket az NVMe-ről — az NVMe-n minden törlődik.
2. Az OMV-ben telepítsd a openmediavault-kvm bővítményt, és csinálj egy hálózati hidat (br0). Utána az OMV új címet kaphat: http://<gépnév>.local vagy a router listája megtalálja.
3. Az OMV-ben szabadítsd fel az NVMe-t (megosztás, mappa, fájlrendszer le), majd töröld a lemezt („Gyors").
4. A KVM bővítményben csinálj egy felhom nevű gépet: 4 CPU, 12 GB memória, a teljes NVMe, a br0 híd, a Felhom telepítő mint CD, automatikus indítás bekapcsolva.
5. Indítsd el, a telepítőben kövesd a szokásos Felhom útmutatót, és a párosító kód után szólj nekem.

---

Mielőtt elkezded

A) A memória. Tedd be a 16 GB-ot. A Felhom gépe 12 GB-ot kap; az OMV-nek a maradék 4 GB bőven elég.

B) A virtualizáció a BIOS-ban. E nélkül a virtuális gép el sem indul.

1. Kapcsold be a gépet, és nyomd a BIOS gombját (a legtöbb mini PC-n F2, F10 vagy Del; a gép az indításkor kiírja).
2. Keresd az Advanced → CPU Configuration (vagy Processor, Security) menüt.
3. Az Intel Virtualization Technology (más néven VT-x) legyen Enabled.
4. Mentsd el (általában F10), és indítsd újra.

C) Mentsd le a filmeket az NVMe-ről. Az NVMe (/dev/nvme0n1, Samsung 980) teljes egészében a Felhomé lesz. A rajta lévő minden fájl törlődik. Másold át a filmeket máshová (például a Toshiba lemezre vagy egy külső lemezre), és nézd meg, hogy a másolat megnyílik-e. Csak ezután menj tovább.

D) Mire lesz még szükséged: az e-mail fiókod; a Tulajdonosi jelmondat (5 szó, tőlem kapod, telefonon); egy monitor és billentyűzet a mini PC-hez arra az esetre, ha az OMV oldala eltűnne.

---

1. A KVM bővítmény telepítése (~2 perc)

1. Lépj be az OMV webes felületére.
2. Rendszer → Bővítmények.
3. A jobb felső keresőbe írd: kvm.
4. Kattints az openmediavault-kvm sorra (sárga lesz).
5. Kattints a lefelé mutató nyílra (Telepítés).
6. A kérdésnél pipáld be a Megerősítés négyzetet, majd Igen.
7. Várd meg a végét („END OF LINE"), majd Bezárás.
8. Frissítsd a böngészőt (Ctrl + Shift + R). Megjelenik a Szolgáltatások → KVM menü.

A KVM bővítmény saját oldalai angolul vannak (VMs, Pools, ISOs …). Az útmutató ezeket a szavakat írja.

2. Egy tároló a telepítőnek (~1 perc)

1. Szolgáltatások → KVM → Pools.
2. + (Add new pool).
3. Név: felhom · Típus: Directory · Path: /srv/felhom-iso
4. Hozzáadás.
5. Jelöld ki a felhom sort, kattints az Állapot gombra, majd Indítás. (Alapból „Inactive"-ként jön létre.)
6. Ha megjelenik a sárga sáv („Függő konfigurációs változások"), kattints a jobb oldali pipára (Alkalmaz), pipáld be a Megerősítés négyzetet, majd Igen.

3. A Felhom telepítő letöltése (~2 perc)

1. Szolgáltatások → KVM → ISOs.
2. Kattints a Download ISO gombra.
3. Storage Pool: felhom
4. URL: https://iso.felhom.eu/felhom-installer-1.29.0-pve9.2-1.iso
5. Checksum: dceacae5da247d76cad065bf6c0d3bbefac8d8a5f8e571db2fd8449a97e94829
6. Letöltés. A végén ezt kell látnod: „Checksum OK." Ha nem ezt látod, szólj.

(Ha addig újabb telepítő jelenik meg a felhom.eu/letoltes oldalon, akkor azt töltsd le, az ott írt ellenőrző összeggel.)

4. A hálózati híd — ez a kényes lépés (~5 perc)

A Felhom gépe csak egy hídon keresztül kerül a lakás hálózatára. A híd elkészítésekor az OMV hálózata újraindul, és az OMV-nek szinte biztosan új címe lesz. Ez várható, nem hiba. Mielőtt elkezded:

• Nézd meg és írd fel az OMV gépnevét (a webes felület jobb felső sarkában látszik, például omv-sim.internal — ebből a omv-sim rész a gépnév).
• Készítsd elő a monitort és a billentyűzetet.

Lépések:

1. Hálózat → Interfészek.
2. Jelöld ki a hálózati kártya sorát (például enp1s0 vagy eno1), és kattints a Törlés gombra → Igen. Még NE kattints a sárga sáv pipájára. (Amíg a kártyának saját beállítása van, a híd nem tudja használni.)
3. Kattints a Létrehozás (+) gombra, és válaszd a Híd lehetőséget.
4. Interfészek: válaszd ki a hálózati kártyát.
5. IPv4 → Módszer: DHCP. A többit hagyd üresen.
6. Mentés.
7. Most kattints a sárga sáv pipájára (Alkalmaz) → Megerősítés → Igen.
8. Az oldal a „Kérjük várjon…" feliratnál megáll. Ez várható: az OMV közben új címet kapott.
9. Várj 2 percet, majd nyisd meg: http://<gépnév>.local (például http://omv-sim.local). Ha ez nem nyílik meg, nézd meg a routered eszközlistájában az OMV gépet és az új címét.
10. Lépj be újra. A Hálózat → Interfészek oldalon most egy br0 sor van, rajta a cím.

Ha az OMV oldala nem jön vissza — lásd lent: „Ha valami nem megy", 1. pont.

Ha Windows-on hálózati meghajtóként csatoltad az OMV megosztásait a régi címmel, azokat a gépnévvel csatold újra (\\<gépnév>\...).

5. Az NVMe felszabadítása (~3 perc)

Ismét: ezután az NVMe-n lévő minden adat elveszik. Csak akkor kezdd el, ha a filmek máshol is megvannak.

1. Szolgáltatások → SMB/CIFS → Megosztások: jelöld ki az NVMe-n lévő megosztás(oka)t → Törlés → Igen.
2. Tárolás → Megosztott mappák: jelöld ki az NVMe-n lévő mappá(ka)t → Törlés → Igen.
3. Tárolás → Fájlrendszerek: jelöld ki a /dev/nvme0n1p1 sort → Leválasztás (a lecsatolás ikon) → Igen.
4. Sárga sáv pipája (Alkalmaz) → Megerősítés → Igen.
5. Tárolás → Lemezek: jelöld ki a /dev/nvme0n1 sort (Samsung 980) → Törlés → pipáld be a Megerősítés négyzetet → Igen → Gyors.
6. Várd meg a végét, majd Bezárás.

Miért kell törölni? A virtuális gép először a lemezről próbál indulni. Ha a lemezen még ott a régi partíció, a gép megáll a „Booting from Hard Disk…" feliratnál, és a telepítő el sem indul. (A próbán pontosan ez történt.)

6. A Felhom virtuális gép (~5 perc)

1. Szolgáltatások → KVM → VMs → Add new VM.
2. Töltsd ki így (ami nincs a listában, azt hagyd, ahogy van):

Mező	Érték
VM name	felhom
OS	Debian 13 (alapból ez)
UEFI	üresen hagyni (a próbán így működött)
CPUs	4
Memória	12 GiB
Volume	Create new disk (alapból ez)
Pool	felhom
Méret	1 Gigabytes (ideiglenes lemez, a 4. lépésben töröljük)
Optical disk	/srv/felhom-iso/felhom-installer-1.29.0-pve9.2-1.iso
Modell	bridge (az alapértelmezett „virtio" NEM jó)
Híd	br0

3. Mentés.
4. Jelöld ki a felhom sort → Hard disk → Add host disk:
   • Disk: a /dev/disk/by-id/nvme-… kezdetű sor. Semmiképp ne a /dev/sda vagy a /dev/sdb — az az OMV saját lemeze, illetve a Toshiba.
   • Bus: virtio (alapból ez).
   • Hozzáadás.
5. Jelöld ki a felhom sort → Hard disk → Remove disk → válaszd a vda :: /srv/felhom-iso/felhom_d1.qcow2 sort → Remove.
6. Jelöld ki a felhom sort → AutoStart → Engedélyezés. (Így az OMV újraindítása után a Felhom magától elindul.)

7. A Felhom telepítése (~15 perc)

1. Jelöld ki a felhom sort → Állapot → Indítás.
2. Jelöld ki → Console. Megnyílik a gép képernyője a böngészőben. (Ezt a gombot a próbán nem nyomtuk meg — a képernyőt más úton néztük.)
3. A telepítő képernyői angol nyelvűek. Ugyanúgy kell kitölteni, mint a szokásos Felhom útmutatóban:

Képernyő	Mit csinálj
End User License Agreement	I agree
Target Harddisk	Hagyd: /dev/vda (kb. 465 GB) → Next
Country / Time zone / Keyboard	Hagyd: Hungary, Europe/Budapest, Hungarian → Next
Password / Confirm	Egy jelszó (a Felhom később lecseréli)
Email	A saját e-mail címed (a mail@example.invalid-ot nem fogadja el)
Hostname (FQDN)	felhom.<a te domained> (a tőlem kapott domain; az alapértelmezettet nem fogadja el) → Next
Summary	Install

4. Kb. 4 perc után a gép magától újraindul. A CD-t nem kell kivenni.
5. A képernyőn megjelenik: „Felhom — a doboz készen áll, és a párosításra vár. Párosító kód: …" Írd fel a kódot, és szólj nekem. Innen a szokásos útmutató 4–7. pontja jön (a „Kösd össze a Felhom dobozodat" e-mail, a jelmondat, majd a „beállító kód" e-mail).

8. Amit tudni érdemes utána

• Az OMV újraindítása: a Felhom gépét az OMV szépen leállítja, és újraindulás után magától elindítja. A próbán a Felhom vezérlőpultja kb. 2 perc múlva újra elérhető volt.
• A Felhom memóriája: a 12 GB-os gépen a Felhom alkalmazásai kb. 7,7 GB-ot kapnak. Ez elég egy háztartás szokásos alkalmazásaihoz (fényképek nélkül bőven, a fényképkezelővel együtt szűkösen). Az első napokban kevés alkalmazással indulunk; a nagy fotógyűjtemény feltöltését együtt csináljuk.
• Mentések: egy lemezen a Felhom a saját mentéseit ugyanarra a lemezre teszi. Ez véd a véletlen törlés és a hibás fájlok ellen, de nem véd az NVMe meghibásodása ellen. Ezt a Felhom vezérlőpultja ki is írja. Ehhez kell egy második meghajtó vagy a távoli mentés — ezt beszéljük meg.
• Második lemez a Felhom gépének: csak akkor véd lemezhiba ellen, ha az OMV gépében egy másik fizikai lemez, és egészében adod át (nem egy fájl ugyanazon a lemezen), Bus: sata. Egy virtuális gépen belül a Felhom ezt nem tudja ellenőrizni, ezért a második lemezre tett másolatot nem számolja második másolatnak, és ezt ki is írja.
• Jellyfin (filmek): az új telepítő egy lemezen is létrehoz egy saját adatterületet („Belső tárhely"), így a Jellyfin és a többi adatot tároló alkalmazás plusz lépés nélkül települ, és a filmek nem kerülnek bele a teljes rendszermentésbe. A Felhom Jellyfinje az OMV hálózati megosztását ma nem tudja filmforrásként használni.
• A Toshiba lemez az OMV-nél marad. Ha később mégis a Felhomnak adnád, a Bus legyen sata (a virtio-t a Felhom nem tudja biztonságosan azonosítani). A Felhom egy virtuális gépen belül nem látja a lemezek állapotjelzőit (SMART) — azokat az OMV figyeli.

Ha valami nem megy

1. Az OMV oldala eltűnt a híd után, és a <gépnév>.local sem nyílik meg.
   • Várj még 2 percet, és nézd meg a router eszközlistáját.
   • Monitorral: az OMV képernyőjén régi cím is állhat — erre ne hagyatkozz. Lépj be root-ként, és írd be: ip -br a — a br0 sor mutatja a valódi címet.
   • Ha a br0 sorban nincs cím: írd be omv-firstaid, és válaszd a hálózati interfész beállítását (a kártyát, DHCP-vel). (Ezt a próbán nem kellett használni, így nem ellenőriztük.) Utána hívj.
2. „Létrehozás → Híd"-nál üres az „Interfészek" lista. A kártyának még van saját beállítása: előbb töröld a kártya sorát (4. rész, 2. lépés), és csak utána csináld a hidat.
3. A Felhom gép képernyője „Booting from Hard Disk…"-nál megáll. A lemezen régi adat maradt. Állítsd le (Állapot → Force), töröld a lemezt (5. rész, 5. lépés), majd indítsd újra.
4. A „Hard disk" gomb szürke. Lemezt csak kikapcsolt gépnek lehet adni vagy elvenni. Kapcsold ki a gépet. Ha a Felhom már fut, a vezérlőpult „Kikapcsolás" gombjával — ez indulás után 10 percig nem engedi („A gép most indult el. 10 perc múlva kapcsolhatod ki."); ez szándékos.
5. A pool „Inactive". Jelöld ki → Állapot → Indítás.
6. A telepítő nem enged tovább: „Please enter a valid Email address" vagy „Hostname does not look like a valid fully qualified domain name" → írd át az e-mail címet, illetve a gépnevet (7. rész táblázata).
7. A virtuális gép el sem indul, és hibát ír a virtualizációról (KVM). A BIOS-ban nincs bekapcsolva a VT-x („Mielőtt elkezded", B).

---

Note for the operator (English)

What worked: the whole path, on an exact OMV 8.5.11-1 copy driven through its own web pages: the KVM plugin installs in 1.5 min; the Felhom ISO downloads inside the plugin with its sha256; the VM boots our ISO with the plugin's default BIOS firmware; the passed NVMe installs in < 4½ min; bind → ONLINE 1.5 min, and the box moved itself to the floor (0.314.0); claim, Vaultwarden, a local whole-guest backup (645 MB) and per-app copy all work; OMV restart with Felhom running is clean (the plugin shuts the guest down and AutoStart brings it back, dashboard in 1 min 52 s). The Felhom guest gets 7.7 GB of the 12 GB VM. What did not / risks for Ferenc: (1) the bridge step changes OMV's IP and hangs the page, and OMV's own console text shows the old address — the guide sends him to <hostname>.local or the router, with monitor steps as the fallback; (2) the plugin boots the disk first, so an un-wiped NVMe hangs the VM — the guide wipes it; (3) the host-disk list offers OMV's own system disk next to the NVMe — one wrong click destroys OMV; (4) on one disk Jellyfin's install is refused with a raw field error (R-1068) — the dashboard's way out (register /mnt/sys_drive) is real in the code but was not pressed here, so do that step with him on the call; (5) Jellyfin cannot use the OMV films share (network storage is browse-only by design, R-108 → R-1071 for your decision); (6) Felhom inside a VM sees no SMART for the NVMe (R-1073) and a second disk on the plugin's default virtio bus cannot be formatted by Felhom (R-1069; sata works); (7) one backup copy only, on the same NVMe, until a second drive or off-site is added. Not checked: UEFI, the plugin's noVNC console page, the real Samsung by-id name, omv-firstaid.

2026-10-21: point (4) is obsolete since installer 1.33.0 (R-1068 closed): a one-disk box gets the data area at install, and the ISO's first boot fetches the current public installer, so ISO 1.29.0 gives it too. The guide's trouble item for the HDD_PATH error and the "we add the data area remotely" sentence were removed.