erpnext/README.md
epistemophiliac 4144bd1115
Some checks failed
Production Readiness / Coolify compose readiness (push) Has been cancelled
Production Readiness / Render and validate stack (push) Has been cancelled
Target epistemophiliac/erpnext and extend CI for Coolify deploy
Point docs at the new Forgejo repo, add compose render artifact upload,
and verify the pinned frappe/erpnext image pulls in CI before Coolify deploy.
2026-06-16 17:56:24 -04:00

1.9 KiB
Raw Blame History

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)

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

Login: user Administrator, password = ADMIN_PASSWORD.

What this stack includes

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

CI

Forgejo Actions runs on every push/PR to main:

  • scripts/ci/ci-readiness.sh — secrets, docs, compose checks
  • scripts/ci/validate-docker-compose.sh — Coolify compose rules + docker compose config

Run locally:

make ci

Requirements

  • Coolify server with 4 GB+ RAM (8 GB recommended)
  • Domain DNS pointing to your Coolify proxy
  • SITE_NAME and FRAPPE_SITE_NAME_HEADER must match the Coolify domain

Documentation

License

Compose and docs: MIT. ERPNext/Frappe images: see upstream licenses.