How to Install ERPNext on Ubuntu 24.04

Install dependencies

System dependencies and software packages must be installed before you can install ERPNext Ubuntu 24.04. Update your system packages and install essential tools like Python and build tools using your terminal to prepare your server for the installation process.

Run the command below to update and upgrade Ubuntu.

sudo apt update
sudo apt upgrade

Next, run the command below to install these package dependencies.

sudo apt-get install libffi-dev python3-pip python3-dev  python3-venv python3-testresources libssl-dev wkhtmltopdf gcc g++ make curl git

Install Node.js and Redis

Node.js and Redis are required backend services to install ERPNext Ubuntu 24.04 successfully. You must install the 💿 correct Node.js version, the Redis server for caching, and the yarn package manager to handle the JavaScript dependencies used by the application.

Also, install the 💿 Redis server and yarn by running the next command.

sudo curl --silent --location https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install nodejs redis-server
sudo npm install -g yarn

Install MariaDB

MariaDB acts as the primary database server to store all your application data when you install ERPNext Ubuntu. You need to install the database server, secure the root installation, and configure the character set settings for the application to work properly.

To install and use the MariaDB database server, use the instructions below.

Open the Ubuntu terminal and run the commands below to install the MariaDB database server.

sudo apt update
sudo apt install mariadb-server

Once the MariaDB database server is installed, use the commands below to stop, start, and enable the MariaDB server to start automatically when the server boots.

sudo systemctl stop mariadb
sudo systemctl start mariadb
sudo systemctl enable mariadb

Run the following commands to validate and test if the MariaDB database server is installed successfully.

sudo mariadb

Once you run the commands above, it will log you onto the MariaDB console and display a message similar to the one below.

Welcome to the MariaDB monitor.  Commands end with ; or g.
Your MariaDB connection id is 32
Server version: 10.11.2-MariaDB-1 Ubuntu 23.04

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.

MariaDB [(none)]> 

The message tells you that the server is installed successfully.

Once MariaDB is installed, run the command below to set the root password.

First, log on to the database by running the sudo mariadb command.

GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'type_password_here';
FLUSH PRIVILEGES;
exit

Additional help on installing MariaDB.

• How to install MariaDB on Ubuntu Linux
• MariaDB without password prompt

Configure ERPNext

A dedicated system user helps you configure ERPNext Ubuntu securely without running applications as the root user. Create a new user account with home directory access, assign proper permissions, and switch to that user account before downloading the application files.

sudo useradd -m -s /bin/bash erpnext
sudo passwd erpnext
sudo usermod -aG sudo erpnext

su - erpnext
nano ~/.bashrc

Add the line below at the end of the file and exit.

PATH=$PATH:~/.local/bin/

Save and close the file, then activate the environment variable with the following command:

source ~/.bashrc

While still switched to the erpnext user, create a directory in /opt called bench.

sudo mkdir /opt/bench
sudo chown -R erpnext:erpnext /opt/bench

Next, change into the /opt/bench directory and clone the bench repository from GitHub.

cd /opt/bench
git clone https://github.com/frappe/bench bench-repo

Next, install using the pip3 command.

pip3 install -e bench-repo

python3 -m pip config set global.break-system-packages true
sudo python3 -m pip config set global.break-system-packages true

Rerun the failed command above.

Once installed, initialize the bench directory using the command below.

bench init erpnext

Next, change into the erpnext directory and create a new site with the following command:

cd /opt/bench/erpnext
bench new-site erpnext.example.com

After running the command above, type the database root password created above to begin the installation.

Enter mysql super user [root]: 
MySQL root password: 

Installing frappe...
Updating DocTypes for frappe        : [====================] 100%
Set Administrator password: 
Updating Dashboard for frappe
erpnext.example.com: SystemSettings.enable_scheduler is UNSET
*** Scheduler is disabled ***

At this point, ERPNext should be installed and ready to use locally.

You can start the bench service using the command below.

bench start

Accessing ERPNext Portal

Now that ERPNext is installed open your browser and browse to the server IP hostname, followed by port 8000.

http://erpnext.example.com:8000

Continue with the wizard.

Create an admin account.

Complete the setup.

ERPNext should be ready to use.

Configure ERPNext for production

Production environments require Nginx as a web server and Supervisor as a process manager to keep your application running reliably. Install these tools alongside the Frappe framework command-line tool to set up automatic restarts and handle live web traffic.

You can do that with the steps below.

First, switch to the erpnext account and install Nginx.

su - erpnext
sudo apt-get install supervisor nginx

Then, install frappe-bench using the command below.

sudo pip3 install frappe-bench

Next, change into the /opt/bench/erpnext folder and setup ERPNext for production environment by running the command below.

cd /opt/bench/erpnext
sudo /home/erpnext/.local/bin/bench setup production erpnext

If everything is right, you should see an output similar to the one below.

Setting Up supervisor...
Setting Up NGINX...
Port configuration list:

Site erpnext.example.com assigned port: 80
Setting Up symlinks and reloading services...
$ sudo /usr/sbin/nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
$ sudo systemctl reload nginx

You can now access the portal using the domain name.

That should do it!

Conclusion:

Installing ERPNext on Ubuntu 24.04 is a straightforward process that can enhance your business operations. Here are key takeaways:

• Comprehensive ERP Solution: ERPNext provides an all-in-one platform for managing various business functions such as finance, human resources, and inventory.
• Cost-Effective: Leveraging Ubuntu as the operating system ensures a stable and budget-friendly environment.
• Simple Installation Process: The step-by-step guide makes it easy for users to install and configure ERPNext.
• Flexibility: Users can customize various features according to their specific business needs and workflows.
• Production-Ready Setup: Additional steps allow for configuring ERPNext in a production environment for enhanced performance and reliability.
• User-Friendly Access: Once installed, users can easily navigate the ERPNext portal for managing business operations efficiently.

By following the outlined steps, you can successfully implement ERPNext and take advantage of its powerful features for your organization.