How to Install ERPNext on MXLinux Latest

ERPNext is an open-source and all-in-one business management software. It includes various features such as inventory management, accounting, project management, HR, and many more. In this tutorial, we will explain how to install ERPNext on MXLinux Latest.

Prerequisites

Before you start with the installation process, you need to ensure that you have the following prerequisites:

Step 1: Install Required Dependencies

First, you need to install some required dependencies on your system. To do so, open the terminal and run the following command:

sudo apt update
sudo apt install python3-minimal build-essential python3-setuptools python3-dev python3-pip python3-apt python3-testresources wkhtmltopdf

Once the installation is complete, you can verify it by checking the installed version of Python3.

python3 -V

Step 2: Install MariaDB

ERPNext uses MariaDB as a database backend. Therefore, you need to install and configure MariaDB on your MXLinux. Run the following command in the terminal:

sudo apt install mariadb-server

After the installation, you need to run the security script to secure your MariaDB installation:

sudo mysql_secure_installation

Answer the prompts as required, answering 'Y' to all of them.

Step 3: Install ERPNext

Now that you have installed all the dependencies and database, you can proceed to install ERPNext using the following command:

sudo pip3 install frappe-bench

This will install the Frappe bench, a command-line tool for managing Frappe and ERPNext sites.

After the installation, you can create a new bench by running the following command:

bench init erpnext

This command will create a new bench directory named "erpnext", where all your ERPNext sites will be stored.

Once the bench is created, navigate to the new directory:

cd erpnext

Now, you can create a new ERPNext site using the following command:

bench new-site my-erpnext-site

This will create a new ERPNext site with the name "my-erpnext-site." Substitute this value with any name of your choice. The command will take some time to complete.

After the site is created, you need to install ERPNext using the following command:

bench --site my-erpnext-site install-app erpnext

Step 4: Enable and Configure Supervisor

Supervisor is a process control system that helps to manage and monitor long-running processes in MXLinux. You can use Supervisor to manage ERPNext processes using the following command:

sudo apt install supervisor

After the installation, create a new Supervisor configuration file for ERPNext:

sudo nano /etc/supervisor/conf.d/erpnext.conf

Add the following contents to the file:

[program:frappe-web]
command=/home/<user>/erpnext/env/bin/gunicorn -b 0.0.0.0:8000 -w 4 frappe.app:application
directory=/home/<user>/erpnext/sites/<site>
user=<user>
autostart=true
autorestart=true
redirect_stderr=true

[program:frappe-worker]
command=/home/<user>/erpnext/env/bin/python /home/<user>/erpnext/sites/<site>/worker.py
directory=/home/<user>/erpnext/sites/<site>
user=<user>
autostart=true
autorestart=true
redirect_stderr=true

Ensure to replace "" and "" in the above file with your system username and site name, respectively.

Save the file and exit.

You can now start the Supervisor service using the following command:

sudo systemctl start supervisor
sudo systemctl enable supervisor

Step 5: Accessing ERPNext

At this point, you have successfully installed ERPNext on your MXLinux system. To access it, launch your browser and navigate to:

http://localhost:8000

Replace "localhost" with the hostname or IP address of your MXLinux server, if accessing from a remote machine.

You will see the ERPNext login page. You can use the credentials you entered during the site creation process to log in.

Conclusion

In this tutorial, we have shown you how to install ERPNext on MXLinux Latest. You can now start exploring the vast features of ERPNext and use it to manage your business processes effectively.

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!