Production ERPNext on Coolify

Validated Docker Compose stack for ERPNext on Coolify, derived from frappe/frappe_docker.

Repository: https://git.aexoradao.com/epistemophiliac/erpnext

Quick start (Coolify)

New Resource → Docker Compose
Git repository: https://git.aexoradao.com/epistemophiliac/erpnext
Compose file: docker-compose.yml
Set environment variables from example.env (at minimum DB_PASSWORD, SITE_NAME, ADMIN_PASSWORD)
Assign your domain to service frontend, port 8080
Deploy — first boot creates the site and installs ERPNext (~5–15 minutes)

Service	Role
`db`	MariaDB 11.8
`redis-cache` / `redis-queue`	Cache and job queue
`configurator`	One-shot bench config
`create-site`	Idempotent site + ERPNext install
`migrator`	`bench migrate` on redeploy
`backend`	Gunicorn API
`frontend`	Nginx (port 8080)
`websocket`	Socket.IO realtime
`queue-short` / `queue-long` / `scheduler`	Background workers

Jenkins runs the same checks on every build via Jenkinsfile:

scripts/ci/ci-readiness.sh — secrets, docs, compose checks
scripts/ci/validate-docker-compose.sh — Coolify compose rules + docker compose config
docker compose config + pull pinned frappe/erpnext image

Jenkins: see docs/JENKINS.md — Multibranch needs Discover branches behaviour, or use a simple Pipeline job on main.

Run locally:

make ci