Come hang with us on Discord and chat directly with the team!Discordtop-bar-close-icon

2024-10-10

How to Install ERPNext on Ubuntu Latest

tutorials
img

Introduction

ERPNext is a comprehensive open-source Enterprise Resource Planning (ERP) suite that helps manage various business processes. This guide will walk you through the installation process of ERPNext on the latest version of Ubuntu.

Prerequisites

Before starting, ensure your server meets the following requirements:

  • A server running the latest version of Ubuntu.
  • At least 2GB of RAM for a smooth installation.
  • Access to a terminal with root privileges.

Step 1: Update Your System

Begin by updating your package list and upgrading all system packages to their latest versions. Open your terminal and execute these commands:

sudo apt update
sudo apt upgrade -y

Step 2: Install Required Packages

Install the necessary packages for ERPNext:

sudo apt install -y python3-minimal build-essential python3-setuptools

Step 3: Install Node.js and Redis

ERPNext requires Node.js and Redis. Install them using the following commands:

curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install -y nodejs
sudo apt install -y redis-server

Step 4: Install Yarn

Yarn is a package manager that ERPNext uses. Install it with:

sudo npm install -g yarn

Step 5: Install MariaDB

ERPNext uses MariaDB as its database. Install and secure it with:

sudo apt install -y mariadb-server
sudo mysql_secure_installation

Follow the prompts to secure your MariaDB installation.

Step 6: Install Frappe Bench

Frappe Bench is a command-line tool to manage ERPNext installations. Install it using:

sudo apt install -y python3-pip
sudo pip3 install frappe-bench

Step 7: Initialize Frappe Bench

Create a new bench directory and initialize it:

bench init --frappe-branch version-14 frappe-bench

Navigate to the bench directory:

cd frappe-bench

Step 8: Create a New Site

Create a new site for ERPNext:

bench new-site yoursite.com

Follow the prompts to set up the site, including entering your MariaDB root password.

Step 9: Install ERPNext

Download and install ERPNext on your site:

bench get-app --branch version-14 erpnext
bench --site yoursite.com install-app erpnext

Step 10: Start the Bench

Start the bench to run ERPNext:

bench start

Step 11: Access ERPNext

Open your web browser and navigate to your server’s IP address with port 8000 (e.g., http://your_ip:8000). You should see the ERPNext login page, where you can log in and start using the platform.

Conclusion

You have successfully installed ERPNext on the latest version of Ubuntu. You can now use ERPNext to manage your business processes efficiently.