Frappe ERPNext On-prem server installation in less than 20 steps
How to Set Up a Frappe ERPNext Site for Production: Step-by-Step Guide
Deploying ERPNext in a production environment ensures stability, security, and performance for your business operations. This guide will walk you through setting up an ERPNext production server using Ubuntu, Nginx, Supervisor, and Let’s Encrypt SSL for security.
1. Prerequisites
Before starting, make sure you have:
| Requirement | Description |
|---|---|
| OS | Ubuntu 22.04 LTS or 20.04 LTS (Recommended) |
| Server Specs | Minimum 4GB RAM, 2 vCPUs, 40GB SSD |
| Access | SSH root or sudo user |
| Domain Name | (Optional but recommended for SSL) |
| Python Version | Python 3.10 or above |
| Database | MariaDB (Recommended) |
2. Update and Install System Dependencies
3. Secure MariaDB Database
Set root password → Yes
Remove anonymous users → Yes
Disallow remote root login → Yes
Remove test database → Yes
4. Setup ERPNext User (Non-Root)
5. Install Bench CLI (Frappe Framework)
6. Initialize a Bench Instance
You can replace
version-15with your preferred branch likeversion-14,develop, etc.
7. Create a New ERPNext Site
It will ask for:
MySQL root password
Admin (Administrator) password for ERPNext login
8. Download and Install ERPNext App
9. Start Development Server (Test Run)
Open in browser:
➡️ http://your_server_ip:8000 or http://yoursite.domain.com:8000
10. Setup for Production
Install Supervisor & Nginx support:
This automatically configures:
✔ Nginx
✔ Supervisor for background jobs
✔ Enabling ERPNext on boot
11. Enable HTTPS (SSL with Let’s Encrypt)
12. Useful Bench Commands
| Command | Description |
|---|---|
bench restart | Restart all services |
bench update | Update ERPNext & dependencies |
bench backup | Create system backup |
bench setup nginx | Regenerate and apply Nginx config |
sudo supervisorctl status | Check worker status |
13. Configure Firewall (Optional but Recommended)
14. Access Your ERPNext Site
✅ Login URL: https://yoursite.domain.com
✅ Default user: Administrator
✅ Login with the password set in Step 7.
15. Bonus Tips
Schedule automatic daily backups to remote storage.
Enable SMTP for outgoing emails.
Install apps like HRMS, POSAwesome, Payments, etc.:
Use fail2ban and SSH keys for security.
Conclusion
By following these steps, you’ve successfully deployed ERPNext in a secure, scalable, and production-ready environment. This setup is ideal for real businesses, hosting on VPS/cloud, and supporting multiple users.