How to Install ERPNext Version 15 on Ubuntu 24.04: A Step-by-Step Guide

Welcome to our comprehensive guide on installing ERPNext Version 15 on Ubuntu 24.04. ERPNext is a powerful, open-source ERP system that streamlines business processes from inventory management to accounting. Whether you’re new to ERPNext or have worked with it for years, this step-by-step tutorial will walk you through the installation process, ensuring you have everything set up correctly on your Ubuntu 24.04 system.

Full Course on Udemy

Prerequisites

To ensure optimal functionality, prepare your server with the following requirements:

Software Requirements

• Updated Ubuntu 24.04
• A user with sudo privileges
• Python 3.11+
• pip 20+
• MariaDB 10.3.x
• Node.js 18
• Yarn 1.12+

Hardware Requirements

• 4GB RAM
• 40GB Hard Disk

Step-by-Step Installation

1. Update and Upgrade Packages

sudo apt-get update -y && sudo apt-get upgrade -y

2. Create a New User

It is advisable to avoid using the root user for daily tasks. Create a Frappe Bench user:

sudo adduser [frappe-user]
sudo usermod -aG sudo [frappe-user]
su [frappe-user]
cd /home/[frappe-user]

Replace [frappe-user] with your desired username, e.g., frappe.

Installing Required Packages

3. Install Git

sudo apt-get install git -y

4. Install Python Dependencies

ERPNext requires Python 3.11+ and other dependencies:

sudo apt-get install python3-dev -y
sudo apt-get install python3-setuptools python3-pip -y
sudo apt install python3.12-venv -y

5. Install MariaDB

ERPNext relies on MariaDB:

sudo apt-get install software-properties-common -y
sudo apt install mariadb-server -y
sudo mysql_secure_installation

During the configuration:

• Set a root password.
• Remove anonymous users.
• Allow remote root login (set N).
• Remove the test database.
• Reload privilege tables.

Edit the MariaDB configuration file:

sudo nano /etc/mysql/my.cnf

Add:

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[mysqld]
default-character-set = utf8mb4

Restart MariaDB:

sudo service mysql restart

6. Install Redis Server

sudo apt-get install redis-server -y

7. Install CURL, Node.js, NPM, and Yarn

Install CURL:

sudo apt install curl

Install Node.js:

curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
source ~/.profile
nvm install 18

Install NPM:

sudo apt-get install npm -y

Install Yarn:

sudo npm install -g yarn -y

8. Install wkhtmltopdf

sudo apt-get install xvfb libfontconfig wkhtmltopdf -y

Setting Up Frappe Bench

9. Install Frappe Bench

sudo -H pip3 install frappe-bench --break-system-packages
sudo -H pip3 install ansible --break-system-packages

10. Initialize Frappe Bench

bench init frappe-bench --frappe-branch version-15
cd frappe-bench

Change directory permissions:

chmod -R o+rx /home/[frappe-user]

11. Create a New Site

bench new-site [site-name]

12. Install ERPNext and Other Apps

Download and install required apps:

bench get-app payments
bench get-app --branch version-15 erpnext
bench get-app hrms
bench --site [site-name] install-app erpnext
bench --site [site-name] install-app hrms

Start the server:

bench start

ERPNext will run on http://[YOUR SERVER IP]:8000.

Deploying ERPNext in Production Mode

13. Enable Scheduler and Disable Maintenance Mode

bench --site [site-name] enable-scheduler
bench --site [site-name] set-maintenance-mode off

14. Setup Production Config

sudo bench setup production [frappe-user]
bench setup nginx

Restart Supervisor:

sudo supervisorctl restart all
sudo bench setup production [frappe-user]

Access your site via the server’s IP without the port number.

Optional: Install SSL Certificate

Follow SSL Cerrtificate process that i explained in n8n installation

You can alternatively use nginx or traefik reverse proxy

Full Course on ERPNext

Full Course on ERPNext Installation and Integration