How to Install ERPNext v14 on Ubuntu 22.04: A Step-by-Step Guide
17 August, 2023 by
How to Install ERPNext v14 on Ubuntu 22.04: A Step-by-Step Guide
Sagar Bhogayata


ERPNext is a powerful open-source ERP (Enterprise Resource Planning) software that provides comprehensive solutions for managing various business processes. With the release of ERPNext v14, there are exciting new features and improvements to explore. In this guide, we'll walk you through the installation process of ERPNext v14 on Ubuntu 22.04, enabling you to leverage the benefits of this versatile software.

Prerequisites

Before we begin, make sure you have the following prerequisites in place:

A clean installation of Ubuntu 22.04.
SSH access to your Ubuntu server.
A user account with sudo privileges.

Step 1: Update Your System

Let's start by updating your system's packages to the latest versions:
sudo apt update
sudo apt upgrade

Step 2: Install Prerequisite Software

ERPNext requires a few software packages to function properly. Install them using the following commands:

sudo apt install python3-minimal python3-dev python3-setuptools python3-pip build-essential python3-testresources
sudo apt install redis-server mariadb-server nginx supervisor

Step 3: Install Node.js and Yarn

ERPNext also depends on Node.js and Yarn. Install them with the following commands:

sudo apt install curl
curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt update
sudo apt install yarn

Step 4: Install wkhtmltopdf

ERPNext requires wkhtmltopdf for generating PDF files. Install it using:

sudo apt install wkhtmltopdf

Step 5: Install ERPNext Bench

sudo pip3 install frappe-bench

Step 6: Create a Bench and Install ERPNext

Create a new Bench and install ERPNext v14:
bench init erpnext-bench --frappe-branch version-14
cd erpnext-bench
bench get-app erpnext --branch version-14
bench --site site1.local install-app erpnext

Step 7: Start ERPNext Services

Start the ERPNext services using the following commands
sudo bench start

Step 8: Access ERPNext

Open your web browser and navigate to http://your-server-ip to access the ERPNext setup wizard. Follow the prompts to configure your ERPNext instance.

Step 9: Configure Supervisor

To make sure ERPNext services start on system boot, configure Supervisor:
sudo bench setup supervisor
sudo bench setup procfile
sudo systemctl enable supervisor
sudo systemctl start supervisor
Step 10: Configure Nginx
Set up Nginx as a reverse proxy to serve ERPNext:


sudo bench setup nginx
sudo systemctl enable nginx
sudo systemctl start nginx

Conclusion

Congratulations! You've successfully installed ERPNext v14 on Ubuntu 22.04. You now have a powerful ERP system at your fingertips to manage various aspects of your business operations. Explore the features, customize the system to your needs, and take advantage of the functionalities ERPNext has to offer.

Share this post
Archive