Private
Private · Docker Deployment
Single-host Docker Compose · Configuration · Health checks
Suitable for small-mid scale (< 200 users) or non-critical scenarios. For production, we recommend Kubernetes + HA.
Topology
Steps
1 · Prepare
2 · Extract the Deployment Package
Layout:
3 · Configure .env
Key variables:
4 · Start
5 · Reverse Proxy + HTTPS
Set up Nginx + Let's Encrypt (or your corporate cert):
Enforce HTTPS:
Common Operations
Backup
Restore
Reverse the dumps. Recommend daily auto-backup to a separate machine / object storage.
Upgrade
Scale-Out
Docker Compose single-host scaling is limited. If needed:
- Add business instances → set
replicason the Web/API service (same host) - Cross-host scale → switch to Kubernetes
Health Checks
| Endpoint | Use |
|---|---|
GET /health | App-layer health (200 / DB connectivity) |
GET /readiness | Readiness check (suits K8s readiness probe) |
Troubleshooting
| Symptom | Check |
|---|---|
| Web 502 | evose-api logs; DB connectivity |
| Model 401 / timeout | Test connection on Model platform; verify credentials |
| Slow KB writes | PostgreSQL memory config (shared_buffers ≥ 25% of host memory) |
| Boots with secret error | Check SECRET_KEY is properly generated 64-char hex |
Next Steps
- Scale up → Kubernetes
- HA → HA
- Upgrade → Upgrade