epistemophiliac
17c2c5ead8
Jenkins builds from apps.json, pushes to Forgejo registry, and archives Coolify image tags; compose installs all apps on first site creation.
68 lines
2.5 KiB
Markdown
68 lines
2.5 KiB
Markdown
# Coolify deployment — Production ERPNext (+ HRMS, Lending, LMS)
|
||
|
||
## Prerequisites
|
||
|
||
- Coolify v4+ with Docker Compose support
|
||
- Jenkins green build published image to `git.aexoradao.com/epistemophiliac/erpnext`
|
||
- Server: **minimum 4 GB RAM**, **8 GB+** recommended (custom image + LMS frontend assets)
|
||
- Public domain (e.g. `erp.yourdomain.com`)
|
||
|
||
## 1. Create the Coolify service (you do this)
|
||
|
||
| Setting | Value |
|
||
|---------|--------|
|
||
| Type | Docker Compose |
|
||
| Repository | `https://git.aexoradao.com/epistemophiliac/erpnext` |
|
||
| Branch | `main` |
|
||
| Compose file | `docker-compose.yml` |
|
||
|
||
## 2. Environment variables
|
||
|
||
From latest **green Jenkins build**, use `dist/coolify-image.env` or:
|
||
|
||
| Variable | Required | Example | Notes |
|
||
|----------|----------|---------|-------|
|
||
| `CUSTOM_IMAGE` | yes | `git.aexoradao.com/epistemophiliac/erpnext` | Forgejo registry |
|
||
| `CUSTOM_TAG` | yes | `main-3eefb73` or `main` | Pin SHA for prod; `main` = latest CI |
|
||
| `PULL_POLICY` | yes | `always` | Pull from registry on deploy |
|
||
| `DB_PASSWORD` | yes | strong secret | MariaDB root |
|
||
| `SITE_NAME` | yes | `erp.yourdomain.com` | Must match domain |
|
||
| `ADMIN_PASSWORD` | yes | strong secret | Frappe login |
|
||
| `FRAPPE_SITE_NAME_HEADER` | yes | same as `SITE_NAME` | Single-site routing |
|
||
| `INSTALL_APPS` | yes | `erpnext,payments,hrms,lending,lms` | First site only |
|
||
| `MIGRATE_SITES` | no | `true` | Migrate on redeploy |
|
||
|
||
> **Coolify env cache:** Changing defaults in `docker-compose.yml` does not update values already stored in Coolify. Edit them in the UI.
|
||
|
||
## 3. Domain routing
|
||
|
||
1. Add domain: `erp.yourdomain.com`
|
||
2. Attach to service **`frontend`**
|
||
3. Port **`8080`**
|
||
|
||
## 4. First deploy timeline
|
||
|
||
```text
|
||
pull custom image → db (healthy) → redis → configurator
|
||
→ create-site (install erpnext + payments + hrms + lending + lms, ~10–20 min)
|
||
→ migrator → backend / workers / frontend
|
||
```
|
||
|
||
## 5. Upgrades
|
||
|
||
1. Push app changes to git → Jenkins builds new image
|
||
2. Set `CUSTOM_TAG` in Coolify to new `main-<sha>`
|
||
3. Redeploy — `migrator` runs `bench migrate`
|
||
|
||
## Apps in the image
|
||
|
||
See [`apps.json`](../apps.json). Site install list: `INSTALL_APPS` in [`example.env`](../example.env).
|
||
|
||
## Troubleshooting
|
||
|
||
| Symptom | Fix |
|
||
|---------|-----|
|
||
| Image pull failed | Check registry login on Coolify host; verify tag exists in Forgejo Packages |
|
||
| create-site fails on LMS | Ensure `payments` is in `INSTALL_APPS` before `lms` |
|
||
| 502 / unhealthy frontend | Wait for create-site; check `backend` health |
|
||
| Wrong site | `SITE_NAME` and `FRAPPE_SITE_NAME_HEADER` must match Coolify domain |
|