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).
• 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.
• Jellyfin (filmek): egy lemezzel a Jellyfin telepítése most egy plusz lépést kér a vezérlőpulton (egy adattároló kijelölését). Ezt a hívás közben együtt csináljuk. 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 Felhom vezérlőpultján a Jellyfin telepítése ezt írja: „a(z) "Médiatár útvonal" (HDD_PATH) mező kitöltése kötelező". Ez egy lemezes gépen várható. Ne próbálkozz tovább — hívj, együtt megcsináljuk.
8. 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.