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.
- **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. Ha a géped egy korábbi telepítővel készült, az adatterületet mi adjuk hozzá távolról — szólj.
  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`.