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

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

English version: VOLUNTEER-first-hour.en.md (localisation slice 6, R-561). A twin, not a rewrite: same sections, same steps, same warnings.

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). An English twin exists from 2026-09-18 (R-559): felhom.eu/en/download. Same installer, same checksum — a site gate refuses the two pages naming different ones. The rest of the marketing site stays Hungarian (operator ruling 1b); this guide is Hungarian until slice 6 (R-561).
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"):

• a távoli másolat alapból be van kapcsolva a new customer (shared, 100 GB) — leave it on unless the customer opts out; without it the household's own files are in no backup on a one-drive box. 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), és beállítja az e-mailek nyelvét (Magyar / English) — a kapcsolódó levél, az összekötő oldal és a doboz első képernyője ezt követi. (2026-09-30) A kapcsolódó linket tartalmazó e-mailt a hub magától küldi, amikor az ügyfélnek van e-mail címe és még nincs gépe (létrehozáskor, e-mail megadásakor, egy korábbi gép törlésekor). A link 7 napig érvényes, és minden új link érvényteleníti az előzőt. Ha a telepítés ennél később lesz, nyomd meg az ügyfél oldalán a „Send self-bind link" gombot aznap — vagy az önkéntes a lejárt link oldalán az „Új linket kérek" gombbal kér újat (hub v0.126.0). (2026-09-30)
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). A tunnel útvonala: *.<domain> → https://traefik, No TLS Verify bekapcsolva (day0-install A.1). (2026-09-30) Ellenőrzi a domain Cloudflare DNS-rekordjait: ha a domaint korábban másik doboz használta, egy régi rekord még a régi tunnelre mutathat — a névnek az ÚJ tunnelre kell mutatnia. (2026-09-30)
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 4 GB-os USB-kulcs. (2026-09-30)
• 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: balenaEtcher (Windows, Mac, Linux), vagy Windows-on Rufus „DD" módban. (2026-09-30)

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ő előre kijelöli az első lemezt — ellenőrizd, hogy az a jó. (2026-09-30) 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	A kijelölés a Previous gombon áll: lépj a jobbra nyíllal az Install-ra, és azt nyomd meg. (2026-09-30)
Summary → „Automatically reboot after successful installation"	Alapból be van pipálva, így a gép a telepítés végén magától újraindul, kérdés nélkül. A másolás alatt húzd ki az USB-kulcsot, vagy vedd ki a pipát, ha inkább te nyomnád meg a „Reboot now"-t. (2026-09-30)

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). Ha azt írja, hogy lejárt, nyomd meg az „Új linket kérek" gombot — pár perc múlva új levél jön. Ha két ilyen levelet kaptál, csak az újabb működik. (2026-09-30)
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. Ha korábban már volt dobozod, a levél tárgya „[Felhom] Új beállító kód — újratelepült a szervered" — ugyanúgy használd. (2026-09-30)
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 hagyd az alapértelmezett aldomaint (wiki, paste). A BookStack egy Admin jelszót is kér: nyomd meg a Generálás gombot. Az „Automatikusan generált értékek" részt nem kell felírnod — a jelszót később is megnézheted (8. lépés). (2026-09-30) Sok alkalmazás a telepítés után csak neked nyílik meg, amíg be vagy jelentkezve a vezérlőpultba: hozd létre benne az első (admin) fiókodat. Utána magától megnyílik mindenkinek, vagy az alkalmazás oldalán nyomd meg a „Kész, beállítottam" gombot. (2026-09-30)
3. Telepítés indítása. A BookStack kb. 1 perc, a PrivateBin kb. 20 másodperc.

7. A helyreállítási kód (~2 perc) — ezt ne hagyd ki

A doboz a fájljaidról titkosított másolatot küld a Felhom távoli tárhelyére. A titkosítás kulcsát csak te kapod meg: ez a helyreállítási kód. Amíg nem hozod létre, a távoli mentés nem indul el.

Amikor a sárga sáv megjelenik (a doboz összekötése után kb. 15 perccel), akkor jött el az ideje. (2026-09-30) A doboz az első perceket a távoli tárhely előkészítésével tölti, és addig a kódot még nem tudja létrehozni — ezért a sáv csak akkor jelenik meg, amikor már lehet. A sáv ezt írja: „A távoli mentés szünetel, amíg nem hozod létre a helyreállítási kódot." Ha a sáv még nincs ott, telepítsd nyugodtan az első alkalmazásokat (előző lépés), és nézz vissza. Ha mégis túl korán nyitod meg az oldalt, azt írja: „A doboz még készül — …pár perc múlva…", és magától frissül.

1. Biztonsági mentés → Távoli mentés, vagy egyszerűen kattints a sávon a „Helyreállítási kód létrehozása" hivatkozásra.
2. Add meg a vezérlőpult jelszavát, és indítsd el. Kb. fél perc.
3. A kód egyetlen egyszer jelenik meg a képernyőn. Írd fel papírra, és tedd el oda, ahová a fontos iratokat teszed. Fénykép a telefonról nem elég, ha a telefon is elveszik.

⚠ A Felhom nem tudja visszaszerezni ezt a kódot. Nem azért, mert nem akarja: a másolataidat úgy titkosítják, hogy mi magunk se tudjuk megnyitni őket. Ha a kód elvész, a távoli másolatok megmaradnak, de senki — mi sem — nem tudja többé megnyitni őket.

Ha ezzel megvagy, a sáv eltűnik, és a távoli mentés magától elindul. Az új alkalmazások maguktól bekerülnek a távoli mentésbe (vezérlő v0.283.0). Ha a Biztonsági mentés oldalon azt látod: „Van alkalmazás, amelyről nem készül távoli mentés. Bekapcsolod mindegyikre?", nyomd meg: „Igen, mindegyikre". Ha az oldal szerint az alkalmazások nem férnek el a távoli tárhelyen, kapcsold ki a távoli mentést annál, amelyiknek nem kell a házon kívül is lennie. (2026-09-30)

8. 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 és a telepítéskor generált jelszó — az alkalmazás Beállítások oldalán az „Admin jelszó" melletti 👁 gomb mutatja meg. A régi password már nem működik. Utána változtasd meg az e-mail címet a sajátodra (jobb felül a profilod → Beállítások). (2026-09-30)
• 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.

9. 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.

10. 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.

11. 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.

12. Á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.

13. 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.