How to Install ERPNext on Elementary OS Latest

ERPNext is a web-based open source ERP software that is designed for small and medium-sized businesses. In this tutorial, we will show you how to install ERPNext on Elementary OS the latest version.

Prerequisites

Before you can install ERPNext, you will need the following:

  • A server running Elementary OS and with root privileges
  • At least 2 GB of RAM
  • At least 20 GB of free disk space

Step 1 - Update your system

The first step is to update your system to ensure you have the latest packages.

sudo apt-get update 
sudo apt-get upgrade 
sudo apt-get dist-upgrade

Step 2 - Install the pre-requisites

ERPNext requires certain pre-requisites to be installed before it can be set up. To install the pre-requisites, run the following command.

sudo apt-get install python3-minimal build-essential python3-setuptools python3-dev python3-pip python3-wheel nginx supervisor redis-server

Step 3 - Install Node.js and Yarn

ERPNext requires Node.js to be installed on your system. To install Node.js and Yarn, run the following commands.

curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash - 
sudo apt-get install -y nodejs 
sudo npm install -g yarn

Step 4 - Create a new user

It is recommended to create a new user to run ERPNext. To create a new user, run the following command.

sudo adduser erpnext

Step 5 - Install ERPNext

Next, you will need to install ERPNext. To do so, follow these steps:

  1. Clone the ERPNext repository
cd ~ 
git clone https://github.com/frappe/erpnext.git 
cd erpnext
  1. Create a new configuration file
cp sites/example.site1.local/site_config.json sites/erpnext.site1.local/site_config.json
  1. Edit the configuration file
nano sites/erpnext.site1.local/site_config.json

Replace the contents of the file with the following:

{
  "db_name": "erpnext",
  "db_password": "<your password>",
  "encryption_key": "<your encryption key>",
  "limits": {
    "space_usage": {
      "backup_size": 5
    }
  },
  "nginx_port": 80,
  "webserver_port": 8000,
  "public_domain": "<your domain name>",
  "ssl_certificate": "",
  "ssl_certificate_key": "",
  "force_https": false,
  "frappe_user": "erpnext",
  "frappe_group": "erpnext",
  "administrator": "admin",
  "mariadb_root_password": "<your root password>",
  "redis_cache": {
    "maxmemory": "2gb"
  },
  "redis_queue": {
    "maxmemory": "2gb"
  },
  "redis_socketio": {
    "maxmemory": "2gb"
  },
  "restart_supervisor_on_update": true
}

Make sure you replace the following values in the configuration file:

  • <your password> - Choose a secure password for the database
  • <your encryption key> - Choose a secure encryption key
  • <your domain name> - The domain name that you will use to access ERPNext
  • <your root password> - Choose a secure password for the database root user
  1. Run the install script
sudo python3 install.py --production --user erpnext --version 13
  1. Start the server
sudo supervisorctl start all

Step 6 - Accessing ERPNext

To access ERPNext, go to your preferred web browser and navigate to <your domain name>:8000. You can log in with the following credentials:

  • Username: admin
  • Password: admin

Conclusion

In this tutorial, we showed you how to install ERPNext on Elementary OS. Now you can start to use ERPNext for your business operations.