server-up/docs
Ramon 952e7ddb7a
All checks were successful
Deploy server-up (dev) / deploy (push) Successful in 1m27s
v0.7.60-beta - app-instellingen nagelopen op fouten bij het installeren
Aanleiding: Homepage weigerde met "Host validation failed" omdat de
standaardwaarde van allowed_hosts poort 3001 noemde terwijl het poortveld op
3002 stond. Alle 96 sjablonen zijn daarop nagelopen.

Systemisch:
- De dobbelsteenknop, waar zeventien apps in hun uitleg naar verwijzen,
  verscheen nooit: hij hing af van een veld 'secret' dat fields() niet
  meestuurde. Wachtwoorden stonden daardoor leesbaar in het formulier.
- 27 velden die je toch nooit zelf typt (databasewachtwoorden, JWT- en
  versleutelingssleutels) worden nu voorgevuld met een willekeurige waarde.
  Inlogwachtwoorden krijgen alleen een knop, want die moet je noteren.
- De knop hangt nu aan 'generate' in plaats van aan 'secret': voor een
  WireGuard-privésleutel of een token uit een andere app is een verzonnen
  waarde juist fout.
- required werd nergens gecontroleerd. Je kon installeren met een leeg
  databasewachtwoord of een lege sleutel. Nu geweigerd bij installeren en bij
  herconfigureren, met vermelding van de lege velden. Velden achter een
  uitgeschakelde groepsschakelaar tellen niet mee.
- Wachtwoorden werden uitgeschreven in het installatielog; nu gemaskeerd.

Losse fouten:
- homepage: allowed_hosts stond op localhost:3001, nu * met uitleg.
- baserow, hedgedoc, ntfy: URL in de standaardwaarde wees naar een poort waar
  niets luistert.
- Vast wachtwoord in acht sjablonen weggehaald: ghost, immich, miniflux,
  paperless-ngx, unifi-network en vikunja kregen allemaal dezelfde
  database-wachtwoorden; grafana en gotify stonden op 'admin'.
- data_dir bij keycloak, metube, miniflux en teslamate stond in het formulier
  maar kwam nergens terecht (die apps gebruiken een Docker-volume).
- puid/pgid bij freshrss: het image kent ze niet.
- prometheus gaf de gevraagde tijdzone niet door.

Nieuw tests/test_app_templates.py: rendert elke app met zijn standaardwaarden
en controleert ongedefinieerde variabelen, velden zonder werking,
niet-gedeclareerde volumes, depends_on, dubbele containernamen,
poortconflicten, poortnummers in standaardwaarden en vaste wachtwoorden.
2236 tests groen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C7oLCRYzY5ixJ5Sv8Y8EFb
2026-07-28 20:08:07 +02:00
..
apps-maken.md v0.7.60-beta - app-instellingen nagelopen op fouten bij het installeren 2026-07-28 20:08:07 +02:00
backups.md v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten 2026-07-28 19:41:35 +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
meldingen.md v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten 2026-07-28 19:41:35 +02:00
netwerken.md v0.5.40-beta - netwerken instellen zonder uitzoekwerk 2026-07-26 23:16:52 +02:00
README.md v0.7.50-beta - meldingen, schijfruimte, backups controleren en extern wegzetten 2026-07-28 19:41:35 +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, geplande backups, controleren, downloaden en een tweede bestemming.
meldingen.md Bericht krijgen als er 's nachts iets misgaat: ntfy, webhook of e-mail, en waarover je gemeld wilt worden.
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.