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

2. Create a new configuration file

cp sites/example.site1.local/site_config.json sites/erpnext.site1.local/site_config.json 

3. 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

4. Run the install script

sudo python3 install.py --production --user erpnext --version 13

5. 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.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!