Generic Frappe / ERPNext Installer
Production-ready automated installer for Frappe Framework and ERPNext on Ubuntu 22.04 / 24.04 with support for ERPNext v15 and v16.
Repository:
frappe-erpnext-quick-install
Maintained By:
Abhishek Chougule
Features
- Fully Automated ERPNext Installation
- Supports ERPNext v15
- Supports ERPNext v16
- Ubuntu 22.04 Support
- Ubuntu 24.04 Support
- Interactive Terminal UI
- Automatic Python Version Selection
- Automatic NodeJS Version Selection
- Automatic MariaDB Configuration
- Automatic Redis Installation
- Automatic Bench Installation
- Automatic Site Creation
- Automatic ERPNext Installation
- Production Setup Included
- NGINX Configuration
- Supervisor Configuration
- SSL Setup with Let’s Encrypt
- Installation Logging
- Existing Installation Detection
- UTF8MB4 MariaDB Optimization
- Scheduler Auto Enable
- Production Ready
Supported Versions
| ERPNext Version | Python Version | NodeJS Version |
|---|---|---|
| v15 | Python 3.10 | NodeJS 18 |
| v16 | Python 3.11 | NodeJS 20 |
Supported Operating Systems
- Ubuntu 22.04 LTS
- Ubuntu 24.04 LTS
Minimum Server Requirements
| Resource | Minimum |
|---|---|
| CPU | 2 Core |
| RAM | 4 GB |
| Storage | 40 GB SSD |
| OS | Ubuntu 22.04 / 24.04 |
Recommended Production Requirements
| Resource | Recommended |
|---|---|
| CPU | 4 Core |
| RAM | 8 GB+ |
| Storage | 80 GB SSD |
| Swap | 4 GB |
Installation
Step 1 Clone Repository
git clone https://github.com/Abhishek-Chougule/frappe-erpnext-quick-install.git
Step 2 Enter Repository
cd frappe-erpnext-quick-install
Step 3 Make Script Executable
chmod +x install.sh
Step 4 Run Installer
./install.sh
Installation Flow
The installer automatically performs:
- System Update
- Dependency Installation
- Python Installation
- NodeJS Installation
- Yarn Installation
- MariaDB Installation
- MariaDB Configuration
- Redis Installation
- Bench Installation
- Bench Initialization
- ERPNext App Installation
- Site Creation
- Production Setup
- NGINX Setup
- Supervisor Setup
- Scheduler Enable
- SSL Installation (Optional)
Interactive Installation
The installer will ask for:
- ERPNext Version
- Bench Name
- Site Name / Domain
- MariaDB Root Password
- Administrator Password
- SSL Installation Preference
Example Installation
ERPNext Version : version-16
Bench Name : frappe-bench
Site Name : erp.example.com
Python Version : 3.11
Node Version : 20
Production Setup
The installer automatically configures:
- NGINX
- Supervisor
- Redis
- Bench Production Mode
- Scheduler
- SocketIO
- System Services
SSL Setup
The installer supports automatic SSL installation using Let’s Encrypt.
Requirements:
- Domain must point to your server IP
- Port 80 and 443 should be open
- Valid DNS configuration
Useful Commands
Go To Bench Directory
cd frappe-bench
Start Development Server
bench start
Restart Production Services
bench restart
Update ERPNext
bench update
Check Bench Health
bench doctor
Check Installed Versions
bench version
Restart Supervisor
sudo supervisorctl restart all
Check Supervisor Status
sudo supervisorctl status
Restart NGINX
sudo systemctl restart nginx
Check NGINX Status
sudo systemctl status nginx
Default Ports
| Service | Port |
|---|---|
| ERPNext | 8000 |
| HTTP | 80 |
| HTTPS | 443 |
| Redis Queue | 11000 |
| Redis SocketIO | 12000 |
| Redis Cache | 13000 |
Installation Log
Installation logs are automatically saved in:
frappe-install.log
Troubleshooting
Bench Command Not Found
Run:
echo 'export PATH=$HOME/.local/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
Fix Supervisor Issues
sudo supervisorctl reload
sudo supervisorctl restart all
Rebuild Assets
bench build
Restart Entire Stack
bench restart
Security Recommendations
- Use strong passwords
- Enable firewall
- Keep Ubuntu updated
- Use SSL in production
- Restrict SSH access
- Configure regular backups
- Disable root login
- Enable fail2ban
Tested Environment
| OS | ERPNext | Status |
|---|---|---|
| Ubuntu 22.04 | v15 | Tested |
| Ubuntu 24.04 | v16 | Tested |
Repository Structure
.
├── install.sh
├── README.md
└── frappe-install.log
Maintainer
Abhishek Chougule
GitHub:
Repository:
License
MIT License
Disclaimer
This installer is provided as-is without warranty. Always test in a staging environment before using in production environments.
