server-up/docs
Ramon 2862f7844c
Some checks failed
Deploy server-up (dev) / deploy (push) Failing after 35s
Deploy server-up (prod) / deploy (push) Failing after 40s
v0.7.30-beta - installatiescript voor Linux
curl -fsSL https://git.ramonbesselink.nl/bes-r/server-up/raw/branch/main/install.sh | sh

install.sh controleert het systeem, biedt aan Docker te installeren als dat
ontbreekt, kloont de repo (of pakt het tar-archief uit als git ontbreekt), maakt
.env aan, bouwt en start, wacht op /healthz en toont waar je terecht kunt met de
waarschuwing meteen een account aan te maken.

- Opties: --dir, --port, --bind, --branch, --token, --update, --uninstall,
  --yes, --dry-run.
- --update haalt nieuwe code op en herstart; .env, stacks en gegevens blijven.
- --uninstall stopt de container maar laat gegevens staan, en vertelt hoe je
  die alsnog opruimt.
- Gebruikt alleen sudo waar nodig: kun je zelf in de doelmap schrijven en
  docker aanroepen, dan blijft alles onder je eigen account.

Tijdens het testen gevonden en verholpen:
- `docker compose --project-directory` zoekt zonder -f het compose-bestand in de
  huidige map; bij `curl | sh` is dat je thuismap. Nu altijd -f erbij.
- De wachtlus gaf anderhalve minuut geen teken van leven; nu een punt per
  poging en 90 in plaats van 120 seconden.
- Bij --dry-run braken ontbrekende Docker-onderdelen de voorvertoning af; nu
  waarschuwingen zodat je de hele gang van zaken ziet.
- De versie-uitlezing uit /healthz tolereert nu ook json met spaties.

Documentatie: docs/installeren.md met alle opties, bijwerken, verwijderen en een
probleemoplostabel; README verwijst ernaar.

Tests: syntaxis onder sh/dash/bash, geen bashismen, --help noemt alle opties,
ongeldige invoer stopt, een proefdraai maakt niets aan, en de installatieregel
in README en docs is identiek.

958 tests groen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01C7oLCRYzY5ixJ5Sv8Y8EFb
2026-07-27 19:30:45 +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.30-beta - installatiescript voor Linux 2026-07-27 19:30:45 +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.