epistemophiliac/erpnext
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
erpnext/README.md
epistemophiliac 17c2c5ead8 Add custom Frappe image build with HRMS, Lending, and LMS. 
Jenkins builds from apps.json, pushes to Forgejo registry, and archives Coolify image tags; compose installs all apps on first site creation.
2026-06-16 19:10:17 -04:00

1.7 KiB
Raw Blame History

Production ERPNext on Coolify

Custom Docker image and Compose stack for ERPNext plus HRMS, Lending, and LMS (Learning) on Coolify. Derived from frappe/frappe_docker.

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

Apps baked into the image

App Source Branch
ERPNext frappe/erpnext version-16
Payments frappe/payments version-16 (required by LMS)
HRMS frappe/hrms version-16
Lending frappe/lending version-16
LMS (Learning) frappe/lms v2.55.0

Defined in apps.json. Edit that file and push to change apps; Jenkins rebuilds the image.

Pipeline (Jenkins)

  1. Validate compose + readiness
  2. Build custom image (images/layered/Containerfile)
  3. Push to Forgejo registry: git.aexoradao.com/epistemophiliac/erpnext:main-<sha> and :main
  4. Archive dist/coolify-image.env with CUSTOM_IMAGE / CUSTOM_TAG for Coolify

See docs/JENKINS.md.

Coolify deploy (you configure)

  1. Docker Compose from this git repo, file docker-compose.yml
  2. Env vars from example.env — use CUSTOM_TAG from latest green Jenkins build
  3. Domain on service frontend, port 8080

See docs/COOLIFY_DEPLOY.md.

Local checks

make ci                              # validate only
BUILD_IMAGE=1 bash scripts/ci/jenkins-run.sh   # build image locally (slow)

Stack services

MariaDB, Redis, configurator, create-site, migrator, backend, frontend (8080), websocket, workers.

License

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