admin
80aeac71f6
gates / gates (push) Successful in 29s
Red-proofs RP40-RP42. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
203 lines
13 KiB
Markdown
203 lines
13 KiB
Markdown
# Felhom — your first hour (for volunteer testers)
|
|
|
|
> **ENGLISH TWIN of `VOLUNTEER-first-hour.md`, written by localisation slice 6 (R-561, 2026-09-2X).**
|
|
> Same sections, same order, same steps, same warnings. **It is a translation, not a rewrite:** where
|
|
> the Hungarian says something that is stale or wrong, the English says what the screen actually
|
|
> shows and the difference is a register row, named in the session report — never a silent fix.
|
|
> The operator chooses the channel and approves the text. This header is for the operator.
|
|
>
|
|
> **Screen names are the dashboard's own English** (`controller/internal/i18n/locales/en.json`):
|
|
> Launcher, Dashboard, Apps, Storage, Backup, Sharing, System monitor, Settings. The console text is
|
|
> the bilingual banner's English block, verbatim. The download step points at the English download
|
|
> page, `felhom.eu/en/download` (published 2026-09-18, R-559 — same installer and same checksum as
|
|
> the Hungarian page; a site gate refuses the two pages naming different ones).
|
|
>
|
|
> **What the operator must still do before sending this** — unchanged from the Hungarian, and listed
|
|
> there in full: create the customer **with the language set to English**, create the Cloudflare
|
|
> tunnel and paste its token (R-494 — without it the dashboard address does not open), and hand over
|
|
> the Owner passphrase out of band.
|
|
|
|
---
|
|
|
|
## What the operator does first (not the volunteer's job)
|
|
|
|
1. Creates the customer on the hub (name, e-mail, domain), **with the language set to English** — the
|
|
claim e-mail, the bind page and the box's first screen all follow that setting.
|
|
The hub **sends the connect e-mail by itself** when the customer has an e-mail address and no box
|
|
yet (at creation, when an address is added, and when an earlier box is deleted). The link is valid
|
|
for **7 days**, and every new link replaces the previous one. If the install is later than that, press
|
|
"Send self-bind link" on the customer page that day — or the volunteer presses **"Send me a new link"**
|
|
on the expired link's page (hub v0.126.0). *(2026-09-30)*
|
|
2. **Creates the Cloudflare tunnel and enters its token** on the customer's page — without it the
|
|
dashboard address does not open (R-494). The tunnel's route: `*.<domain>` → `https://traefik`, with
|
|
**No TLS Verify** on (day0-install A.1). *(2026-09-30)*
|
|
**Checks the domain's Cloudflare DNS records**: if an earlier box used the domain, an old record may
|
|
still point at the old tunnel — the name must point at the NEW tunnel. *(2026-09-30)*
|
|
3. **Hands over the "Owner passphrase" in person or in a message.** No e-mail contains it. It is
|
|
six English words for an English account, five Hungarian ones for a Hungarian account (R-597).
|
|
|
|
## What you will need
|
|
|
|
- A machine where **all data will be erased** (the install overwrites the chosen disk completely).
|
|
- A USB stick of at least 4 GB. *(2026-09-30)*
|
|
- A network cable to your router.
|
|
- The **Owner passphrase** (a few hyphen-joined words) you received from Felhom.
|
|
- The e-mail account you gave to Felhom.
|
|
|
|
## 1. Download the installer (~1 minute)
|
|
|
|
Open **https://felhom.eu/en/download** and download the installer it names (about 1.7 GB). The page
|
|
also gives the file's checksum (SHA-256).
|
|
|
|
Write it to a USB stick: balenaEtcher (Windows, Mac, Linux), or on Windows Rufus **in "DD" mode**. *(2026-09-30)*
|
|
|
|
## 2. Install (~15 minutes, about 3 of them copying)
|
|
|
|
Start the machine from the USB stick. **The installer screens are in English** — that is expected.
|
|
|
|
| Screen | What to do |
|
|
|---|---|
|
|
| Felhom logo, two lines | Choose **"Felhom telepítés / Install Felhom"** (or wait; it starts by itself). The second line, **"… (szöveges mód) / … (text mode)"**, installs exactly the same thing without the graphics — take it if the first one shows nothing. |
|
|
| END USER LICENSE AGREEMENT | **I agree** |
|
|
| Target harddisk | The installer **pre-selects the first disk** — check that it is the right one. *(2026-09-30)* It lists the machine's disks with their size and type; choose the one **the system should go on — that disk will be erased.** Unplug your external backup drive for the install. If there are several internal disks and you do not know which is the right one, stop and ask the operator. |
|
|
| Country / Timezone / Keyboard | Set the **Keyboard Layout** to the one your keyboard actually has (**U.S. English** for most English keyboards). The Hungarian guide says to leave this alone, and for a Hungarian keyboard that is right — but if the layout does not match your keyboard you will type a root password you cannot reproduce. Country and Time zone can stay as they are. |
|
|
| Root password | Enter a password of at least 8 characters, twice. **You do not need to remember it** — Felhom replaces it after the first start. |
|
|
| Administrator email | Type your own e-mail address (instead of `mail@example.invalid`) |
|
|
| Hostname (FQDN) | **Change it**, because the default is refused. Type: `felhom.<your-domain>` (the domain you got from Felhom) |
|
|
| IP address, Gateway, DNS | Leave as they are |
|
|
| Summary | The highlight rests on **Previous**: move to **Install** with the right arrow, and press that. *(2026-09-30)* |
|
|
| Summary → **"Automatically reboot after successful installation"** | This is **ticked by default**, so the machine reboots ON ITS OWN when the install finishes — you will not be asked. **Take the USB stick out while the install is still running**, or untick that box if you would rather press Reboot yourself. (The Hungarian guide describes a *"Installation finished — reboot now?"* prompt; with the default settings that prompt does not appear.) |
|
|
|
|
## 3. The first start (~2 minutes)
|
|
|
|
**This screen is bilingual** — Hungarian first, English under it. About 2 minutes later it shows:
|
|
|
|
> Felhom — the box is ready and waiting to be paired.
|
|
> Pairing code: XXX-XXX
|
|
|
|
Write the **pairing code** down. It is printed once in each language; both are the same code.
|
|
|
|
## 4. Connect the box to your account (~2 minutes)
|
|
|
|
1. Open the e-mail with the subject **"[Felhom] Link your Felhom box to your account"** and follow the link in it
|
|
(valid for 7 days). If it says the link has expired, press **"Send me a new link"** — a new e-mail
|
|
arrives in a few minutes. If you received two such e-mails, only the newer one works. *(2026-09-30)*
|
|
2. Enter:
|
|
- the **pairing code** from the box's screen;
|
|
- the **Owner passphrase** you received from the Felhom operator.
|
|
3. Leave the box switched on. The next e-mail arrives in **about 3 minutes**.
|
|
|
|
*(Note: the box's screen keeps showing the pairing code after it is connected — this is a known
|
|
fault, and you do not need to connect it again.)*
|
|
|
|
## 5. Set up the dashboard (~1 minute)
|
|
|
|
1. Open the e-mail with the subject **"[Felhom] Your Felhom server is up — setup code"**. If you had a
|
|
box before, the subject says your server was **reinstalled** and asks for a new setup code — use it
|
|
the same way. *(2026-09-30)*
|
|
2. Follow the address in it (`https://felhom.<your-domain>`).
|
|
If the address does not open, tell the operator.
|
|
3. On the **"Set up the server"** page enter the **setup code** and choose a password of **at least
|
|
12 characters**. This becomes your dashboard password.
|
|
**The code is the words in your e-mail, joined by hyphens** (for example
|
|
`abacus-wreath-ratio-abdomen`). You can type it or paste it; capitals and spaces instead of
|
|
hyphens are accepted. If it looks like Hungarian words with accents, tell the operator — an
|
|
English account should receive English words (R-597, fixed 2026-09-21).
|
|
4. If the code did not arrive: **"Did not get the code? Ask for a new one"** — it always goes to the
|
|
same e-mail address.
|
|
|
|
## 6. Install your first two apps (~2 minutes)
|
|
|
|
1. On the dashboard: **Apps**. Find **BookStack** (a family wiki) and **PrivateBin** (encrypted
|
|
notes), and select **Install**.
|
|
2. On the install page leave the default **subdomain** (`wiki`, `paste`). BookStack also asks for an
|
|
**admin password**: press **Generate**. You do not need to write down the "Automatically generated
|
|
values" — you can see the password later (step 8). *(2026-09-30)*
|
|
*Many apps open **only for you** after the install, while you are signed in to the dashboard: create
|
|
your first (admin) account in it. After that it opens for everyone by itself, or press "Done, I set it
|
|
up" on the app's page.* *(2026-09-30)*
|
|
3. **Start the install.** BookStack takes about a minute, PrivateBin about 20 seconds.
|
|
|
|
## 7. The recovery code (~2 minutes) — do not skip this
|
|
|
|
The box sends an **encrypted** copy of your files to Felhom's remote storage. **Only you** get the
|
|
key to that encryption: it is the **recovery code**. Until you create it, **the remote backup does
|
|
not start**.
|
|
|
|
**When the yellow bar appears (about 15 minutes after the box is connected)**, that is the moment. *(2026-09-30)* The box spends
|
|
its first minutes preparing the remote storage, and until then it cannot create the code — which is
|
|
why the bar only appears once it can. The bar says:
|
|
"Remote backup is paused until you create your recovery code."
|
|
If the bar is not there yet, install your first apps (the step before) and look again.
|
|
If you open the page too early it says "The box is still getting ready — … in a few minutes …", and
|
|
it refreshes itself.
|
|
|
|
1. **Backup → Remote backup**, or simply select **"Create recovery code"** on the bar.
|
|
2. Enter your dashboard password and start it. About half a minute.
|
|
3. The code is shown **once and once only**. **Write it on paper** and put it where you keep your
|
|
important documents. A photo on your phone is not enough if the phone is lost too.
|
|
|
|
> ⚠ **Felhom cannot get this code back for you.** Not because we will not: your copies are encrypted
|
|
> so that we ourselves cannot open them. If the code is lost, the remote copies remain, but
|
|
> **nobody — not us either — can open them again**.
|
|
|
|
Once you are done, the bar disappears and the remote backup starts by itself. New apps go into the
|
|
remote backup by themselves (controller v0.283.0). If the Backup page says "Some apps have no off-site
|
|
copy. Turn it on for all of them?", press **"Yes, all of them"**. If the page says the apps do not fit in
|
|
the off-site storage, turn the off-site copy off for the apps that do not need one outside the house. *(2026-09-30)*
|
|
|
|
## 8. Signing in to the apps for the first time
|
|
|
|
- **BookStack:** on the app's page the "First steps" give the address as `wiki.DOMAIN` — put your own
|
|
domain in place of DOMAIN (known fault). Sign in: `admin@admin.com` and the password generated at the
|
|
install — the 👁 button beside "Admin password" on the app's **Settings** page shows it. The old
|
|
`password` no longer works. Then change the e-mail to your own (your profile at the top right →
|
|
Settings). *(2026-09-30)*
|
|
- **PrivateBin:** there is no sign-in. Type your text, select **Send**, and share the link you get —
|
|
the key is in the link, and the server does not see the content.
|
|
|
|
## 9. Backups
|
|
|
|
- **Backup → Overview:** you will see two yellow warnings, in English. One says only one copy is
|
|
being made and there is no second drive. The other is, word for word:
|
|
|
|
> The system backup is currently on the same disk as the system — so it protects against corrupted files, but not against a disk failure. Attach a second drive for full protection.
|
|
|
|
**Both are true**: until there is a second drive or a remote backup, this does not protect you
|
|
against a disk failure. (They were Hungarian until 2026-09-21 — R-598, now closed.)
|
|
- **Backup → Apps → Back up now:** about 20 seconds, after which the date updates.
|
|
- *An individual app's "Backup 2 settings" page may say that its data is "already part of the full
|
|
system backup (PBS)" — this is not true on every box (known fault). The Overview page is the
|
|
accurate one.*
|
|
|
|
## 10. Restoring
|
|
|
|
**Backup → Restore:** choose the app and the backup, tick the "I understand" box, **Start restore**.
|
|
The app stops for about half a minute, then starts again in the state of the last backup.
|
|
|
|
## 11. Removing an app
|
|
|
|
**Apps:** first **Stop**, then **Remove** appears. The dialog lists what will be deleted in any case,
|
|
and you can also tick the box to delete the backups.
|
|
|
|
## 12. A power cut
|
|
|
|
If the power goes, the box comes back by itself; after about 2 minutes every app is running on the
|
|
same version it was before. You will have to sign in to the dashboard again.
|
|
|
|
## 13. If you mistype the code
|
|
|
|
The setup page rejects it and you can type it again. A wrong code answers
|
|
**"Wrong or expired code"**, and after **five** wrong attempts the page locks for 15 minutes with
|
|
**"Too many attempts — try again in 15 minutes."** A password under twelve characters answers
|
|
**"The password must be at least 12 characters long"**. You can ask for a new code with the
|
|
"Did not get the code? Ask for a new one" link, and the sign-in page's "Forgot password" link leads
|
|
to the same place.
|
|
|
|
*(These messages were Hungarian until 2026-09-21 and were the one screen that stopped the first
|
|
English walk — R-596, now closed.)*
|
|
|
|
## If you get stuck
|
|
|
|
Write to **support@felhom.eu**, and send a screenshot if you can.
|