felhom.eu/documentation/runbooks/VOLUNTEER-first-hour.md

Felhom — az első óra (önkéntes tesztelőknek)

STOPGAP, written by the 2026-09-14 drill (R-493) — NOT yet sent to anyone. No customer-facing install instruction existed when the drill started, so this is the minimal honest one, built from what the product really shows on 0.242.0. The operator chooses the channel and approves the text. Hungarian below; this header is for the operator.

Every step this document adds beyond what exists today (none of these is written anywhere a volunteer can see):

1. Where the installer is, by exact file name — iso.felhom.eu has no index page (R-493).
2. That the installer screens are English Proxmox screens, and what to type on each.
3. A hostname to type — the installer refuses its own default pve.example.invalid.
4. An e-mail to type — the installer prefills mail@example.invalid.
5. To remove the USB stick at „Installation finished — reboot now?".
6. To ignore the English „Please use your web browser … https://…:8006/" block on the console — that is the Proxmox admin page, not Felhom.
7. That „a jelszavadat" on the console means the 5-word „Tulajdonosi jelmondat", and that it comes from the operator, not by mail.
8. How to reach the dashboard — UNRESOLVED: the setup-code mail's link does not resolve for a new customer unless the operator made a Cloudflare tunnel by hand (R-494). Step 5 below says what the operator must do before sending this document.

Operator prerequisites this document silently depends on (§ „Az üzemeltető előtte"): create the customer; hand over the Tulajdonosi jelmondat out of band; create the Cloudflare tunnel and paste its token (day-0 runbook A.1) — until R-494 is ruled.

---

Az üzemeltető előtte (nem az önkéntes feladata)

1. Létrehozza az ügyfelet a hubon (név, e-mail, domain).
2. Létrehozza a Cloudflare tunnelt és beírja a tokent az ügyfél adatlapján — enélkül a vezérlőpult címe nem nyílik meg (R-494).
3. Személyesen vagy üzenetben átadja a 5 szóból álló „Tulajdonosi jelmondatot". Ezt semmilyen e-mail nem tartalmazza.

Mire lesz szükséged

• Egy gép, amelyen minden adat törlődik (a telepítés a kiválasztott lemezt teljesen felülírja).
• Egy legalább 2 GB-os USB-kulcs.
• Hálózati kábel a routeredhez.
• A Felhomtól kapott Tulajdonosi jelmondat (5 szó).
• Az e-mail fiókod, amelyet a Felhomnak megadtál.

1. A telepítő letöltése (~1 perc)

Töltsd le ezt a fájlt (kb. 1,7 GB):

https://iso.felhom.eu/felhom-installer-1.26.1-pve9.2-1.iso

Ellenőrző összeg (SHA-256), ha szeretnéd ellenőrizni: f3cc86d5f0ec68bba4155c994b4fa84e208d50209bb6e815636c99e5441059a6

Írd ki USB-kulcsra (Windows: Rufus, „DD" módban; Mac/Linux: balenaEtcher).

2. Telepítés (~15 perc, ebből ~3 perc másolás)

Indítsd a gépet az USB-kulcsról. A telepítő képernyői angolul vannak — ez rendben van.

Képernyő	Mit csinálj
Felhom logó, két sor	Válaszd a „Felhom telepítés" sort (vagy várj, magától elindul)
END USER LICENSE AGREEMENT	I agree
Target harddisk	Válaszd azt a lemezt, amelyre a rendszer kerüljön. Ha több lemez van, a legnagyobb nem feltétlenül a jó — a külső adatlemezeket ne válaszd.
Country / Timezone / Keyboard	Hagyd így: Hungary, Europe/Budapest, Hungarian
Root password	Adj meg egy legalább 8 karakteres jelszót kétszer. Nem kell megjegyezned — a Felhom az első indulás után lecseréli.
Administrator email	Írd be a saját e-mail címedet (a mail@example.invalid helyett)
Hostname (FQDN)	Írd át, mert az alapértelmezettet nem fogadja el. Írd be: felhom.<a-te-domained> (a Felhomtól kapott domain)
IP address, Gateway, DNS	Hagyd, ahogy van
Summary	Install
„Installation finished — reboot now?"	Húzd ki az USB-kulcsot, majd Reboot now

3. Az első indulás (~2 perc)

A képernyőn először egy angol szöveg jelenik meg („Welcome to the Proxmox Virtual Environment… connect to: https://…:8006/"). Ezzel nincs teendőd — ne nyisd meg.

Alatta megjelenik a Felhom:

Felhom — a doboz készen áll, és a párosításra vár. Párosító kód: XXX-XXX

Írd fel a Párosító kódot.

4. A doboz összekötése a fiókoddal (~2 perc)

1. Nyisd meg a „[Felhom] Kösd össze a Felhom dobozodat" tárgyú e-mailt, és kattints a benne lévő hivatkozásra (7 napig érvényes).
2. Add meg:
   • a Párosító kódot a doboz képernyőjéről;
   • a Tulajdonosi jelmondatot (5 szó). A doboz képernyője ezt „jelszónak" hívja — ugyanaz.
3. Hagyd bekapcsolva a dobozt. Kb. 3 perc múlva megérkezik a következő e-mail.

(Megjegyzés: a doboz képernyője az összekötés után is a párosító kódot mutatja — ez ismert hiba, nem kell újra összekötni.)

5. A vezérlőpult beállítása (~1 perc)

1. Nyisd meg a „[Felhom] Elindult a Felhom szervered — beállító kód" tárgyú e-mailt.
2. Kattints a benne lévő címre (https://felhom.<a-te-domained>). ⚠ Ha a cím nem nyílik meg, szólj az üzemeltetőnek — ez most ismert akadály (R-494).
3. „A szerver beállítása" oldalon add meg a Beállító kódot (3 szó, pl. szó-szó-szó), és válassz legalább 12 karakteres jelszót. Ez lesz a vezérlőpult jelszava.
4. Ha nem jött meg a kód: „Új kód kérése" — mindig ugyanarra az e-mail címre érkezik.

6. Az első két alkalmazás telepítése (~2 perc)

1. A vezérlőpulton: Alkalmazások. Keresd meg például a BookStack-et (családi wiki) és a PrivateBin-t (titkosított jegyzet), és nyomd meg a Telepítés gombot.
2. A telepítő oldalon csak az aldomain a kérdés — hagyd az alapértelmezettet (wiki, paste). Az „Automatikusan generált értékek" részt nem kell felírnod.
3. Telepítés indítása. A BookStack kb. 1 perc, a PrivateBin kb. 20 másodperc.

7. Első belépés az alkalmazásokba

• BookStack: az alkalmazás oldalán az „Első lépések" rész a címet wiki.DOMAIN alakban írja — a DOMAIN helyére a saját domained kerül (ismert hiba). Belépés: admin@admin.com / password. Azonnal változtasd meg: jobb felül a profilod → Beállítások → jelszó és e-mail.
• PrivateBin: nincs belépés. Írj be szöveget, Küldés, és a kapott linket oszd meg — a kulcs a linkben van, a szerver nem látja a tartalmat.

8. Mentések

• Biztonsági mentés → Áttekintés: két sárga figyelmeztetést látsz („Csak egy másolat készül", „ugyanazon a lemezen van") — ezek igazak: amíg nincs második meghajtó vagy távoli mentés, egy lemezhiba ellen nem véd.
• Biztonsági mentés → Alkalmazások → Mentés most: kb. 20 másodperc, utána a dátum frissül.
• Az egyes alkalmazások „2. mentés beállítása" oldala azt írhatja, hogy az adatok „már szerepelnek a teljes rendszermentésben (PBS)" — ez nem minden dobozra igaz (ismert hiba). Az Áttekintés oldal a pontos.

9. Visszaállítás

Biztonsági mentés → Visszaállítás: válaszd az alkalmazást és a mentést, pipáld be a „Megértettem" négyzetet, Visszaállítás indítása. Az alkalmazás kb. fél percre leáll, majd az utolsó mentés állapotával indul újra.

10. Alkalmazás eltávolítása

Alkalmazások: előbb Leállítás, utána megjelenik az Eltávolítás. A párbeszédablak felsorolja, mi törlődik mindenképp, és bepipálhatod a mentések törlését is.

11. Áramszünet

Ha elmegy az áram, a doboz magától visszaindul, kb. 2 perc múlva minden alkalmazás ugyanazon a verzión fut, amelyen előtte. A vezérlőpultba újra be kell jelentkezned.

12. Ha elgépelted a kódot

A beállító oldal „Hibás vagy lejárt kód" üzenettel visszadobja — írd be újra. Öt hibás próbálkozás után 15 percre zárol („Túl sok próbálkozás — próbáld újra 15 perc múlva."). Új kódot a „Nem kaptad meg a kódot? Új kód kérése" linkkel kérhetsz, és a bejelentkező oldal „Elfelejtett jelszó" linkje ugyanide vezet.

Ha elakadsz

Írj a support@felhom.eu címre, és ha tudsz, küldj képernyőképet.