To integrate and rationalize processes into unified movements, businesses rely on ERP systems nowadays, even ERPNext-Innovative, compared to open-source ERP software-possesses flexibility, affordability, and overall features it provides-from accounting, go to inventory, right up to HR and CRM-then award-winning flexibility on the site has well-proven construction-with easy user interfaces. The modules are customized to fit businesses of all sizes by automating and smoothing out possible avenues for increased productivity within. It’s to be installed on a very Ubuntu server to provide a reliable, secure, and scalable foundation for impressive software deployment.

This article will embark on a comprehensive tutorial that demonstrates the steps involved in installing ERPNext on an Ubuntu server. A detailed step-by-step guide makes it convenient for beginners and experts alike to set up their robust ERP systems within this article. This tutorial will prepare you for setting up your server, installing ERPNext, optimizing it, and securing your protocols. Make an ERPNext host instance on a dedicated server like that on DedicatedCore, ensuring reliable and quick performance, as well as seamless scalability, to focus on growth instead of infrastructure limitations.

This part form covers all the essential prerequisites: hardware, software, the complete installation process, and configuration guides after installation, followed by best practices to put in place around keeping healthy, almost for maintaining your ERPNext instance. And now, at the end of this guide, the case could be where you’re left with a fully functional ERPNext system, ready to partner with the business in getting some work done behind it. Give it a try. Let’s start wiring it up to get to the core of ERPNext on Ubuntu.

Requirements:

To ensure a smooth installation and optimal performance of ERPNext on Ubuntu, you need to meet specific operating system, hardware, and software requirements. Below is a breakdown of these prerequisites.

Operating System

ERPNext is compatible with Ubuntu, and for this guide, we recommend using Ubuntu 20.04 LTS or Ubuntu 22.04 LTS. These Long-Term Support versions offer stability, security updates, and compatibility with ERPNext’s dependencies. Ensure your Ubuntu installation is up-to-date with the latest patches and security updates before proceeding.

Hardware

The hardware requirements for ERPNext depend on the size of your organization and the expected workload. Below are the minimum and recommended specifications:

  • Minimum Requirements:
    • CPU: 2-core processor (e.g., Intel Xeon or AMD equivalent)
    • RAM: 4 GB
    • Storage: 40 GB SSD (for OS, ERPNext, and database)
    • Network: Stable internet connection with at least 10 Mbps bandwidth

Pre-Installation Tips

If you are planning to use ERPNext on Ubuntu, make sure you use the following tips during the booting phase. Below are some quick preparation tips that could come in handy while installing ERPNext to avoid mistakes for your Ubuntu server:

  1. Update the System: Run sudo apt update && sudo apt upgrade -y to ensure all packages are up-to-date.
  2. Setup a Non-Root User: Create a user with sudo privileges for security. This avoids the root account being used to do the installation.
  3. Configure Firewall: Use ufw to allow ports 80 (HTTP), 443 (HTTPS), and 22 (SSH). For example, sudo ufw allow 80,443,22/tcp.
  4. Free Disk Space: Check around your server to make sure there is enough free disk space for ERPNext and its database, and for any data growth that will occur later.
  5. Backup Important Data: Back up important data if this server is providing other applications in order to avoid unintentional data loss.
  6. A Stable Connection: Connected to a reliable network for downloading packages and dependencies without interruption.
  7. Choose a Domain (optional): If you’re going to access ERPNext using a domain, then make these changes in advance in the DNS settings.
  8. Choose a Hosting Provider: Going for a hosting provider like DedicatedCore to have optimized servers with SSD storage and scalable resources will ensure ERPNext runs smoothly.

With the requirements and tips mentioned above, a good groundwork for the installation of ERPNext is laid. Thereafter, the sections include the detailed procedure for installing, configuring, and optimizing your ERP system.

Why Is It Necessary to Install ERPNext?

Installing ERPNext on an Ubuntu server is essential for businesses aiming to centralize and optimize their operations. ERPNext integrates critical functions like accounting, inventory, sales, HR, and project management into a single platform, reducing manual processes and improving efficiency. Its open-source nature eliminates costly licensing fees, making it accessible for businesses of all sizes. By hosting ERPNext on a reliable Ubuntu server, such as those offered by DedicatedCore, you ensure scalability, security, and performance, enabling real-time data access and streamlined workflows. This setup empowers organizations to make informed decisions, enhance productivity, and adapt to growth seamlessly.

Steps and Process

The installation of ERPNext on Ubuntu involves setting up the server, installing dependencies, configuring the environment, and deploying ERPNext using the Frappe Bench tool. Below is a concise step-by-step guide to get ERPNext up and running.

Step 1: Connect to Your Server

  1. Access your Ubuntu server via SSH using a terminal or SSH client:
ssh username@your_server_ip

Replace username with your non-root user and your_server_ip with your server’s IP address.

  1. Ensure you have sudo privileges for the installation process.

Step 2: Update the System

  1. Update the package list and upgrade installed packages:
sudo apt update && sudo apt upgrade -y
  1. Reboot the server if necessary:
sudo reboot

Step 3: Install Required Dependencies

  1. Install essential packages for ERPNext:
sudo apt install -y python3-dev python3-pip python3-venv git curl software-properties-common mariadb-server mariadb-client redis-server nginx
  1. Install Node.js (version 16.x):
curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -

sudo apt install -y nodejs
  1. Install wkhtmltopdf for PDF generation:
sudo apt install -y wkhtmltopdf

Step 4: Configure MariaDB

  1. Secure the MariaDB installation:
sudo mysql_secure_installation

Follow the prompts to set a root password, remove anonymous users, and disable remote root login.

  1. Configure MariaDB for ERPNext by editing /etc/mysql/my.cnf:
sudo nano /etc/mysql/my.cnf
  1. Add the following under the [mysqld] section:
[mysqld]

character-set-client-handshake = FALSE

character-set-server = utf8mb4

collation-server = utf8mb4_unicode_ci
  1. Restart MariaDB:
sudo systemctl restart mariadb

Step 5: Install Frappe Bench

  1. Create a new user for ERPNext to enhance security:
sudo adduser --disabled-password --home /home/frappe frappe

sudo usermod -aG sudo frappe
  1. Switch to the frappe user:
su - frappe
  1. Install Bench:
pip3 install --user frappe-bench
  1. Add Bench to the PATH:
echo 'export PATH=$PATH:~/.local/bin' >> ~/.bashrc

source ~/.bashrc

Step 6: Initialize Bench and Install ERPNext

  1. Initialize a new Bench directory:
bench init frappe-bench

cd frappe-bench
  1. Set up a new ERPNext site:
bench new-site site1.local --db-root-username root --db-root-password your_mysql_root_password

Replace your_mysql_root_password with the MariaDB root password.

  1. Install the ERPNext app:
bench get-app erpnext

bench --site site1.local install-app erpnext

Step 7: Configure Nginx and Supervisor

  1. Set up production mode for ERPNext:
sudo bench setup production frappe

This configures Nginx and Supervisor for ERPNext.

  1. Enable and start Nginx:
sudo systemctl enable nginx

sudo systemctl start nginx

Step 8: Access ERPNext

  1. Open a web browser and navigate to http://your_server_ip or your domain if configured.
  2. Log in with the default credentials:
    • Username: Administrator
    • Password: The password set during site creation (check the frappe-bench/sites/site1.local/site_config.json file if needed).
  3. Complete the setup wizard to configure your organization’s details.

Step 9: Verify Installation

  1. Ensure all ERPNext modules (e.g., Accounts, Inventory, HR) are accessible.
  2. Test basic functionalities like creating a new user or adding a sales order.
  3. Monitor server performance to confirm resource usage is within expected limits.

By following these steps, you’ll have a fully functional ERPNext instance running on your Ubuntu server. Hosting on a robust platform like DedicatedCore ensures your ERPNext setup benefits from high-speed SSD storage and scalable resources, minimizing downtime and maximizing efficiency.

Frequently Asked Questions (FAQs)

Below are three technical FAQs related to installing and managing ERPNext on Ubuntu, designed to address common concerns and provide clarity for users.

1. How can I optimize MariaDB performance for ERPNext on Ubuntu?

To optimize MariaDB for ERPNext, adjust the my.cnf configuration to allocate appropriate memory and caching based on your server’s resources. For instance, set innodb_buffer_pool_size to 50-70% of your RAM for better query performance. Additionally, ensure regular database maintenance, such as optimizing tables and indexing, to maintain efficiency as your ERPNext data grows.

2. What should I do if I encounter a “Bench command not found” error after installation?

This error typically occurs if the Bench executable is not in your system’s PATH. To resolve it, verify that you’ve added export PATH=$PATH:~/.local/bin to your ~/.bashrc file and sourced it using source ~/.bashrc. If the issue persists, reinstall Bench using pip3 install –user frappe-bench as the frappe user and confirm the installation path.

3. How do I secure my ERPNext instance on Ubuntu to prevent unauthorized access?

Securing ERPNext involves enabling HTTPS with an SSL certificate (e.g., using Let’s Encrypt), configuring a strong firewall with ufw to allow only necessary ports (80, 443, 22), and regularly updating ERPNext and its dependencies. Additionally, use strong passwords for the MariaDB root user and ERPNext Administrator account, and restrict SSH access to specific IP addresses for enhanced security.

Resources

In furtherance, to aid one another in installing, managing, and optimizing ERPNext in Ubuntu, below set forth is an assemblage of reliable external resources. These references give some further assistance with troubleshooting and community support for ERPNext deployment.

1. The official ERPNext Documentation

ERPNext documentation itself installs and configures too many modules, even customizing them. It compels the understanding of everything that the platform knows and goes a long way in troubleshooting the same.

URL: https://docs.erpnext.com

2. Frappe Framework Documentation

The documentation of the Frappe Framework is relevant as ERPNext runs on this framework. It mainly contains all the technical details of the Bench commands, site management, and advanced configurations, significantly appealing to developers and system administrators.

URL: https://frappeframework.com/docs

3. Documentation of Ubuntu Server

Canonical describes in its documentation the server setup, security, and package management, which constitute those important aspects necessary for maintaining a stable ERPNext environment.

URL: https://ubuntu.com/server/docs

4. DedicatedCore Hosting Solutions

DedicatedCore brings high-performance VPS and dedicated server hosting solutions with SSD storage for ERPNext hosting. Their support team assists with server optimization, especially for ERP applications.

URL: https://www.dedicatedcore.com

Final Words on the Installation of ERPNext on Ubuntu

Installing ERPNext on an Ubuntu server is an intelligent choice by an organization wanting to streamline its processes and future-proof itself. This document has taken you through the entire process of realizing the importance of ERPNext in any industry with a proper, secure, and efficient installation.

Using the dedicated hosting offered at DedicatedCore will ensure your instance of ERPNext works with optimal performance and scalability. Start your ERPNext journey today and become certified, unleashing the potential of integrated business management.