drill: a stranger's first hour on 0.242.0 — 1 intervention, not ready for a volunteer
gates / gates (push) Successful in 21s

Golden 0.242.0 baked, round-trip verified and vouched (cadence rule, R-468).
Fresh box from the public ISO on demo-hp: landed on the vouched set, two apps
deployed and used, backup, remove, byte-identical restore, power cut and code
typo all PASS. Stopped for a volunteer by R-493 (no instructions) and R-494
(the setup mail's dashboard link has no DNS; intervention I1). R-493..R-500
filed. Capability map: first-hour row added (PARTIAL), journey row scoped.
Stopgap Hungarian volunteer guide written. Hub teardown layer pending.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
This commit is contained in:
2026-09-14 16:17:47 +02:00
parent 41590f8ee6
commit 38848ffbeb
62 changed files with 7988 additions and 1 deletions
@@ -0,0 +1,158 @@
# 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.