ERPNext is a highly acclaimed open-source enterprise resource planning (ERP) software that helps businesses manage operations, including accounting, sales, purchase, inventory, human resources, projects, and more. Its flexibility and comprehensive suite of applications make it an ideal choice for small to medium-sized enterprises (SMEs) looking to streamline their business processes. This guide is designed to help newcomers install ERPNext on Ubuntu 23.04, providing step-by-step instructions with real examples of command lines for installation and configuration.

Step 1: System Update and Required Dependencies

  1. Update Your System: Start by updating the package lists for upgrades and new package installations:
   sudo apt update && sudo apt upgrade -y
  1. Install Required Dependencies: ERPNext relies on several packages, including Python, MariaDB, Redis, Node.js, Nginx, and others. Install the necessary dependencies by running:
   sudo apt install python3-minimal build-essential python3-setuptools python3-pip mariadb-server redis-server nginx git nodejs npm -y

Step 2: Install Bench CLI

Bench is a command-line utility that simplifies the installation and management of ERPNext. Install Bench using Python pip:

  1. Install Pip and Wheel:
   sudo apt install python3-pip
   pip3 install wheel
  1. Install Bench:
   sudo pip3 install frappe-bench

Step 3: Create a New Frappe Bench

The Bench CLI allows you to create a new instance of the Frappe framework (which ERPNext is built on) and manage multiple sites.

  • Create a New Bench:
   bench init my-bench && cd my-bench

Replace my-bench with your desired bench name.

Step 4: Create a New ERPNext Site

Once the bench is set up, the next step is to create a new ERPNext site within the bench.

  1. Create a New Site: Before creating a new site, ensure MariaDB is running and properly configured. Then, use the bench to create a new ERPNext site:
   bench new-site mysite.localhost

Replace mysite.localhost with your desired site name. You will be prompted to set the MySQL root password and the administrator password for the new site.

  1. Get the ERPNext App: Download the ERPNext app onto your bench:
   bench get-app erpnext
  1. Install ERPNext on Your Site:
   bench --site mysite.localhost install-app erpnext

Step 5: Start ERPNext

With ERPNext installed, you’re now ready to start the bench and access your ERPNext site.

  1. Start the Bench:
   bench start
  1. Access ERPNext: Open your web browser and go to http://mysite.localhost:8000 to access your ERPNext site. Log in using the administrator credentials you set earlier.

For businesses looking to deploy ERPNext in a production environment, considering a Cloud VPS solution from Shape.host is advisable. Shape.host offers robust, scalable Liniux SSD VPS services, ensuring that your ERPNext installation is supported by high-performance computing resources, enhanced security, and reliable uptime. With Shape.host, you can easily manage your ERPNext instance, allowing you to focus on optimizing your business processes without worrying about the underlying infrastructure.