How to install ERPNext on Void Linux

ERPNext is a popular and comprehensive open-source ERP system that is ideal for small and medium businesses. In this tutorial, we will guide you on how to install ERPNext on your Void Linux machine.

Prerequisites

Before you can start with the installation process, ensure that your system has met the following prerequisites:

  • A clean installation of Void Linux.
  • A user account with root privileges.
  • A stable internet connection.

Step 1: Install the required dependencies

To ensure the successful installation of ERPNext on Void Linux, you will need to install some essential dependencies. Open your terminal and update your system’s package index by running the following command:

xbps-install -Syu

Afterward, install Python3 and some other tools required by ERPNext using the following command:

xbps-install -y python3-pip build-base libffi-devel libressl-devel nodejs

Once the installation is complete, verify that you have installed the required dependencies by printing their versions using the following command:

node --version && npm --version && pip3 --version

Step 2: Install and configure MariaDB

ERPNext requires MariaDB to store its data. So, let's install MariaDB using the following command:

xbps-install -y mariadb

After installation, start the MariaDB service on your machine and enable it to start automatically on system boot. Enter the following commands:

ln -sv /etc/sv/mariadb /var/service/
sv start mariadb
sv enable mariadb

Next, run the secure installation script for MariaDB as shown below:

mysql_secure_installation

Follow the on-screen prompt to configure and secure your MariaDB instance.

Step 3: Create a Python virtual environment

Now, we'll create a Python virtual environment to install and run ERPNext. To create a Python virtual environment, run the following command:

python3 -m venv erpnext

Activate the virtual environment by typing:

source erpnext/bin/activate

Step 4: Install ERPNext

After activating the Python virtual environment, we are ready to install ERPNext. Run the following command to install ERPNext using pip:

pip3 install frappe-bench

After the installation is complete, create a new bench and install ERPNext by running the following commands:

bench init frappe-bench && cd frappe-bench
bench new-site erpnext.example.com
bench --site erpnext.example.com install-app erpnext

Step 5: Configure the Firewall

By default, Void Linux disables all incoming traffic. To allow access to your ERPNext installation, you need to open the following Firewall ports:

  • 80/tcp (HTTP)
  • 443/tcp (HTTPS)

Use the following command to open these ports:

iptables -I INPUT -p tcp --dport 80 -j ACCEPT && iptables -I INPUT -p tcp --dport 443 -j ACCEPT

You can also make these port openings permanent by saving them in the Firewall rules configuration:

iptables-save > /etc/iptables/rules.v4

Step 6: Accessing ERPNext

After successfully installing and configuring the ERPNext, visit your browser and navigate to http://<your-server-IP>. You will be taken to ERPNext’s first-time setup page, where you can configure the site as per your needs.

Conclusion

That’s it! You have successfully installed ERPNext on your Void Linux machine. Now, you can enjoy the powerful capabilities provided by ERPNext!