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

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

> **English version: [`VOLUNTEER-first-hour.en.md`](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.