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

1.2 KiB

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

# 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

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.