Installation

Estimated reading: 2 minutes 34 views

📝 Table of Contents

  1. System Requirements

  2. Pre-Installation

  3. Database Configuration

  4. Frappe & ERPNext Installation

  5. Production Deployment (NGINX & Supervisor)

  6. Post-Installation Setup

  7. Security Tips

  8. Troubleshooting

✅ System Requirements

Component Minimum Requirement
OS Ubuntu 22.04 LTS (64-bit)
RAM 2 GB minimum (4 GB recommended)
CPU 1 vCPU minimum
Disk 20 GB+
Access Root or sudo user

⚙️ Pre-Installation

1. Update System

sudo apt update && sudo apt upgrade -y

2. Install Required Packages

sudo apt install -y git python3-dev python3-pip python3-venv \
build-essential libffi-dev libssl-dev libmysqlclient-dev libjpeg-dev \
zlib1g-dev libpq-dev curl wget nodejs npm

3. Create System User

sudo adduser --system --home=/opt/erpnext --group erpnext

🛢️ Database Configuration

1. Install MariaDB

sudo apt install mariadb-server mariadb-client -y
sudo mysql_secure_installation

2. Create Database & User

sudo mysql -u root -p

CREATE DATABASE erpnext_db;
CREATE USER 'erpnext_user'@'localhost' IDENTIFIED BY 'StrongPassword123';
GRANT ALL PRIVILEGES ON erpnext_db.* TO 'erpnext_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

🧱 Frappe & ERPNext Installation

1. Install Node.js & Yarn

sudo npm install -g yarn

2. Install Redis Server

sudo apt install redis-server -y

3. Install Frappe Bench CLI

sudo pip3 install frappe-bench

4. Create New Bench & Site

bench init erpnext-bench --frappe-branch version-15
cd erpnext-bench
bench new-site erp.mysite.local

5. Get ERPNext App

bench get-app erpnext --branch version-15
bench --site erp.mysite.local install-app erpnext

6. Run Development Server

bench start

Access via: http://localhost:8000

🚀 Production Deployment (NGINX & Supervisor)

1. Setup Production Environment

sudo bench setup production erpnext

This installs:

  • NGINX reverse proxy

  • Supervisor process manager

  • Auto-start services on boot

2. Setup SSL (Optional)

sudo bench setup lets-encrypt erp.mysite.local

Leave a Reply

Your email address will not be published. Required fields are marked *

Share this Doc

Installation

Or copy link

CONTENTS

Powered By EazyDocs

Scroll to Top