erp-next/deploy/README.md
cclohmar 759fac5a67 chore: add deploy config with systemd services for auto-start on boot
- frappe-bench-web, worker, schedule, socketio, watch services
- frappe-bench.target to group all services
- bench-env.sh wrapper for proper PATH resolution
- deploy README with installation/management instructions
2026-07-15 20:44:59 +00:00

44 lines
1.2 KiB
Markdown

# Deployment Configuration
## Systemd Services
The Frappe Bench (ERPNext) is managed via systemd for automatic startup on boot.
### Services
| Service | Description | Port |
|---------|-------------|------|
| `frappe-bench-web.service` | Web server (gunicorn) | 8000 |
| `frappe-bench-worker.service` | Background async worker | - |
| `frappe-bench-schedule.service` | Scheduled job runner | - |
| `frappe-bench-socketio.service` | Realtime WebSocket server | 9000 |
| `frappe-bench-watch.service` | File watcher (dev/assets) | - |
### Management
```bash
# View status of all services
systemctl status frappe-bench-web.service
# Start/Stop all services
systemctl start frappe-bench.target
systemctl stop frappe-bench.target
# View logs
journalctl -u frappe-bench-web.service -f
journalctl -u frappe-bench-worker.service -f
```
### Installation
```bash
sudo cp deploy/frappe-bench-*.service deploy/frappe-bench.target /etc/systemd/system/
sudo cp deploy/bench-env.sh /opt/erpnext/frappe-bench/bench-env.sh
sudo systemctl daemon-reload
sudo systemctl enable frappe-bench.target
sudo systemctl start frappe-bench.target
```
### Credentials
Admin credentials are stored in `/root/erpnext-admin-credentials.txt`.