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 — the Hungarian download page felhom.eu/letoltes (published with ISO v1.27.0 after the operator's yes; iso.felhom.eu/ itself still has no index — R-504).
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 Proxmox console block — removed in ISO v1.27.0 (R-496): the console shows Felhom's Hungarian text.
7. That „a jelszavadat" means the Tulajdonosi jelmondat — removed in ISO v1.27.0 / hub v0.113.0 (R-496, R-497): console, mail and page use one name; the mail says the operator hands it over.
8. How to reach the dashboard — ruled 2026-09-14: every customer has their own domain and the operator creates the tunnel (day-0 A.1) before sending this document. R-494 is narrowed to P3.

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)

Nyisd meg a https://felhom.eu/letoltes oldalt, és töltsd le az ott megadott telepítőt (kb. 1,7 GB). Az oldal a fájl ellenőrző összegét (SHA-256) is megadja.

Í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	A telepítő soha nem választ helyetted. Felsorolja a gép lemezeit méretükkel és típusukkal; válaszd azt, amelyre a rendszer kerüljön — ez a lemez törlődik. A külső mentőlemezt a telepítés idejére húzd ki. Ha több belső lemez van és nem tudod, melyik a jó, állj meg és szólj az üzemeltetőnek.
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 ez jelenik meg: „Felhom otthoni szerver — Ezen a képernyőn nincs teendőd, bejelentkezni sem kell." Alatta, kb. 2 perc múlva:

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ó), amelyet a Felhom üzemeltetőjétől kaptál.
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.
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.