Files
govoplan-core/dev/production-like/README.md
Albrecht Degering 94236a7d7e
Some checks failed
Dependency Audit / dependency-audit (push) Failing after 50s
Module Matrix / module-matrix (push) Failing after 49s
Prepare GovOPlaN self-hosted release workflow
2026-07-10 21:57:22 +02:00

1.6 KiB

Production-Like Development Profile

This profile runs the shared services that production depends on while keeping API, worker, and WebUI code in the editable local repositories.

It provides:

  • PostgreSQL with a persistent Docker volume
  • Redis with append-only persistence
  • explicit ENABLED_MODULES
  • local durable file storage under runtime/production-like/files
  • a Celery worker process using the same queues as the API

Start it from the core repository:

cd /mnt/DATA/git/govoplan-core
scripts/launch-production-like-dev.sh

The helper wrapper exposes repeatable lifecycle commands:

cd /mnt/DATA/git/govoplan-core
scripts/production-like-dev.sh validate-config
scripts/production-like-dev.sh seed
scripts/production-like-dev.sh start
scripts/production-like-dev.sh stop
scripts/production-like-dev.sh reset --yes

The launcher uses dev/production-like/.env when present, otherwise dev/production-like/.env.example. Copy the example when you want local port or password changes:

cp dev/production-like/.env.example dev/production-like/.env

The API and worker use:

DATABASE_URL=postgresql+psycopg://govoplan:govoplan-dev@127.0.0.1:55433/govoplan
REDIS_URL=redis://127.0.0.1:56379/0
CELERY_ENABLED=true

Stop the launched API/WebUI/worker with Ctrl+C. The PostgreSQL and Redis containers keep running by default so the next launch is fast. To stop them too:

GOVOPLAN_STOP_PROFILE_DEPENDENCIES_ON_EXIT=1 scripts/launch-production-like-dev.sh

To remove all profile data:

cd /mnt/DATA/git/govoplan-core
scripts/production-like-dev.sh reset --yes