wSFcQyxBu1/opnform
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Ref-kopie + git-bron van de OpnForm docker-compose deploy (forms.doc-gen.eu, CX33). GEEN route B.
6 commits 1 branch 0 tags 56 KiB
Find a file
claude-macmini e8f5155046 Fix HTTP 000: pin traefik.docker.network=coolify op ingress + ui-healthcheck 127.0.0.1 
Root cause: ingress op meerdere netwerken zonder traefik.docker.network-label ->
Traefik koos soms een app-net-IP waar het zelf niet op zit -> verbinding hangt (000)
na een container-IP-wissel. Nu vastgepind op coolify. ui-healthcheck via 127.0.0.1
(localhost->::1 gaf onterecht unhealthy).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-09-10 02:20:44 +02:00
docker-compose.yml Fix HTTP 000: pin traefik.docker.network=coolify op ingress + ui-healthcheck 127.0.0.1 2026-09-10 02:20:44 +02:00
README.md README: mail 587/STARTTLS + netwerk-isolatie-notitie 2026-09-08 21:26:55 +02:00

README.md

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.
  • Nginx-ingress-config staat INLINE in de compose (top-level configs: → content:), niet als los bestand: Coolify materialiseert bij een git-compose alleen de compose + .env in de app-map, niet de overige repo-bestanden — een ./docker/nginx.conf-bind-mount wordt dan een lege map. Inline is self-contained. De nginx-$-variabelen zijn als $$ geschreven (docker compose zet $$→$).

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:**587** (STARTTLS) — niet 465: Hetzner knijpt uitgaand 25/465 af op de CX33. Beheerdersaccounts: gratis self-hosted OpnForm staat max. 2 gebruikers toe (formulier-invullers tellen niet mee — die zijn anoniem/ongelimiteerd).

De backend-services (api/db/redis/ui) draaien op het privé compose-netwerk; alleen de ingress hangt óók aan het gedeelde coolify-net (voor Traefik). Dat moet: op het gedeelde net botst de generieke naam redis/db met Coolify's eigen coolify-redis/coolify-db → de api kreeg anders NOAUTH van de verkeerde redis (500 bij registratie).

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.