server-up/docs
Ramon 8e53b90615
All checks were successful
Deploy server-up (dev) / deploy (push) Successful in 1m14s
Deploy server-up (prod) / deploy (push) Successful in 1m44s
Release / release (push) Successful in 5s
v0.7.40-beta - beheerdersaccount en bind meteen klaarzetten
Het installatiescript kan nu allebei zelf regelen, zodat je na afloop niet
meer naar de webinterface hoeft om een account te claimen en niet meer in
.env hoeft te duiken om erbij te kunnen.

Beheerdersaccount:
- Op een terminal wordt gevraagd of je er meteen een wil, met naam en
  wachtwoord (twee keer, echo uit).
- Automatisch via --admin NAAM plus --admin-password-file of
  SU_ADMIN_PASSWORD; zonder bron en zonder terminal maakt het script er
  zelf een van 24 tekens en toont die.
- --admin-password weigert bewust: argumenten zijn zichtbaar in 'ps'. Het
  wachtwoord gaat via stdin naar curl, niet als argument.
- Nieuw --create-admin voor een installatie die al draait.

Bereikbaarheid:
- Keuzemenu voor BIND (deze server / hele netwerk / eigen adres), met het
  gedetecteerde serveradres erbij.
- Bij opnieuw installeren is de bestaande instelling het uitgangspunt, zodat
  enter je server niet ongemerkt terugzet op loopback.

Opgeloste fouten:
- Een bestaande .env bleef altijd ongemoeid, ook met --bind: de installatie
  leek te lukken terwijl de server op het oude adres bleef luisteren.
- --update rekende met de standaardpoort in plaats van met wat er in .env
  staat, waardoor de wachtlus en het slotadres niet klopten.
- --dry-run riep 'sudo docker' aan en vroeg dus om een wachtwoord terwijl
  het net beloofd had niets te doen; zonder terminal liep het daarop vast.
- Ongeldig bind-adres en poort buiten 1-65535 worden nu meteen geweigerd.

Getest met een pseudo-terminal voor de vragen en tegen een echt draaiende
server voor het aanmaken van het account, inclusief een wachtwoord vol
aanhalingstekens en backslashes, een geweigerd tweede account en een server
die niet reageert. De e2e-tests slaan zichzelf over waar curl ontbreekt,
zoals in het CI-image. 992 tests groen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C7oLCRYzY5ixJ5Sv8Y8EFb
2026-07-27 21:13:06 +02:00
..
apps-maken.md v0.7.20-beta - instellingen wijzigen, koppelen achteraf, defect uit v0.7.00 2026-07-27 15:43:49 +02:00
backups.md v0.5.20-beta - complete backups en updates per app 2026-07-26 19:54:51 +02:00
beveiliging.md .env.example toevoegen met alle instellingen erin 2026-07-26 23:35:11 +02:00
forgejo-actions-setup.md v0.3.1 - UI restyle, inklapbaar menu, taalmodule 2026-06-02 23:25:30 +02:00
installeren.md v0.7.40-beta - beheerdersaccount en bind meteen klaarzetten 2026-07-27 21:13:06 +02:00
netwerken.md v0.5.40-beta - netwerken instellen zonder uitzoekwerk 2026-07-26 23:16:52 +02:00
README.md v0.7.30-beta - installatiescript voor Linux 2026-07-27 19:30:45 +02:00
synchroniseren.md v0.3.1 - UI restyle, inklapbaar menu, taalmodule 2026-06-02 23:25:30 +02:00
updates.md Duidelijker maken waarom de updateknop uit staat bij een zelfgebouwd image 2026-07-26 23:23:30 +02:00

Documentatie

Document Waarover, en wanneer je het nodig hebt
installeren.md Installeren met één regel, alle opties van het script, bijwerken en verwijderen.
beveiliging.md Accounts, rollen, reverse-proxy-SSO en TLS. Lees dit voordat je Server Up van buiten je netwerk bereikbaar maakt — toegang tot de interface staat gelijk aan root op de host.
apps-maken.md Eigen apps toevoegen: het volledige template.json-formaat, de compose-syntaxis, apps aan elkaar koppelen en onderdelen optioneel maken.
netwerken.md Stacks een eigen IP-adres geven in je LAN met macvlan of ipvlan. Inclusief de valkuil dat de host zijn eigen macvlan-containers niet bereikt.
backups.md Wat er wél en niet in een backup zit, terugzetten, bewaarbeleid en geplande backups.
updates.md Update-kanalen (stable en beta), bijwerken vanuit de interface, en de Forgejo-registry inrichten.
synchroniseren.md Code van je eigen apparaat automatisch naar de server krijgen via Forgejo.
forgejo-actions-setup.md De act_runner installeren en instellen.

Zie ../README.md voor installeren en een overzicht van wat Server Up doet.