OpnForm — forms.doc-gen.eu

Self-hosted, open-source formulierenbouwer (OpnForm) op de Hetzner CX33, voor cursusevaluaties, inschrijvingen, kennistoetsen en bestand-inleveren. EU-soeverein (Hetzner + eigen mailserver), geen Amerikaanse diensten in de draaiende keten.

Deze repo is de ref-kopie / bron van waarheid van de deploy-configuratie én tegelijk de git-bron die Coolify klont om te deployen.

⚠️ Uitzondering: dit draait NIET via route B

Anders dan casuspositie/doc-gen/transcriber/oefendossiers/joplin/freescout/hedgedoc is OpnForm multi-image en wordt het als Coolify docker-compose-service (git-based) gedraaid, met exact gepinde image-tags:

• Geen registry-image, geen Forgejo Actions/CI (er wordt niets gebouwd).
• Geen host-watcher-entry — voeg OpnForm dus niet toe aan deploy-watcher/watch.sh.
• Coolify klont deze repo en draait docker compose up. De losse docker/nginx.conf wordt door Coolify niet geïnterpoleerd (bevat nginx-$-variabelen) — dáárom git-based i.p.v. een raw compose-blok.

Zie ook de infra-skill forgejo-coolify-pipeline (§ OpnForm) en runbook runbooks/opnform-cx33.md.

Componenten (compose)

service	image (gepind)	rol
api	jhumanj/opnform-api:1.13.2	Laravel API (php-fpm :9000) — draait zelf de migraties bij boot
api-worker	idem	queue-worker (mail, exports)
api-scheduler	idem	cron/scheduler
ui	jhumanj/opnform-client:1.13.2	Nuxt SSR frontend (:3000)
redis	redis:7.4.11	sessies, cache, queue
db	postgres:16.15	database
ingress	nginx:1.30.4	HTTP↔FastCGI + /-routing → het enige web-endpoint (poort 80)

Persistente volumes: postgres-data, opnform_storage (geüploade formulier-bestanden, lokaal — geen S3), redis-data.

Domein/Traefik/LE: via de Coolify-magie SERVICE_FQDN_INGRESS_80 op de ingress-service. APP_URL/FRONT_URL/NUXT_PUBLIC_* volgen automatisch ${SERVICE_URL_INGRESS}.

Updaten naar een nieuwe OpnForm-versie

1. Kijk de nieuwe tag na op Docker Hub (jhumanj/opnform-api, jhumanj/opnform-client) en de bijbehorende release notes. Controleer of docker-compose.yml/docker/nginx.conf/de env-variabelen in die release zijn gewijzigd (vergelijk met OpnForm/OpnForm op de tag) en neem wijzigingen hier over.
2. Bump de twee jhumanj/opnform-*-tags (en evt. postgres/redis/nginx) in docker-compose.yml.
3. git commit + git push naar main.
4. In Coolify (tunnel ssh deploy@46.224.126.208 -L 8000:localhost:8000 → http://localhost:8000, óf via de API met de Mac-Mini-COOLIFY_TOKEN): de OpnForm-resource Redeploy. De api-container draait bij boot zelf php artisan migrate --force.
5. Verifieer: curl -sL -o /dev/null -w '%{http_code} %{ssl_verify_result}\n' https://forms.doc-gen.eu/ → 200 0.

Secrets & env

Staan niet in deze repo. Ze leven in de Coolify-env van de resource en in ~/.config/doc-gen-deploy/opnform.env (0600) op de Mac Mini: APP_KEY, JWT_SECRET, FRONT_API_SECRET, DB_PASSWORD, DB_DATABASE, DB_USERNAME, MAIL_USERNAME, MAIL_PASSWORD, MAIL_FROM_ADDRESS, en SERVICE_FQDN_INGRESS_80.

Mail loopt via mail.2487.eu:465 (SSL). Beheerdersaccounts: gratis self-hosted OpnForm staat max. 2 gebruikers toe (formulier-invullers tellen niet mee — die zijn anoniem/ongelimiteerd).

Coolify-object

• Resource-type: Docker Compose (git), project My first project / env production, server localhost (CX33).
• App-uuid: zie infra-issue en runbooks/opnform-cx33.md.

Beheer, backup & health

• Backup: pg_dump van de OpnForm-Postgres + het opnform_storage-volume in de off-site restic-backup (/usr/local/bin/docgen-backup.sh, niet-fataal).
• Health: opnform-health.timer (5 min, curl .../ → 200, ntfy docgen-backup bij 2× niet-200).
• Eerste admin: ga naar https://forms.doc-gen.eu/ → /setup en maak het beheerdersaccount (e-mail + wachtwoord). Publieke registratie staat daarna uit; extra gebruikers via uitnodiging.

Volledige onboarding + verificaties: infra-runbook runbooks/opnform-cx33.md.