Reading list Switch to dark mode

    How to install Erpnext on Ubuntu

    Updated 18 September 2023

    In this blog, we are going to learn how to install ERPNext on the Ubuntu server.

    First, we will create a new user and provide sudo access to it, we will use this user for all the ERPNext-related operations. We are creating a user “webkul” you can give it any name accordingly.

    sudo adduser webkul
    usermod -aG sudo webkul

    After that switch to the new user.

    su webkul
    cd /home/webkul

    Before installing ERPNext we need to install other packages which are required for Erpnext.


    Start your headless eCommerce
    Find out More
    sudo apt-get install git


    sudo apt-get install python3-dev python3.10-dev python3-setuptools python3-pip python3-distutils

    Python Virtual Environment

    sudo apt-get install python3.10-venv

    Software Properties Common

    sudo apt-get install software-properties-common

    MariaDB (database)

    sudo apt install mariadb-server mariadb-client

    Redis Server

    sudo apt-get install redis-server

    Other Packages

    sudo apt-get install xvfb libfontconfig wkhtmltopdf

    MySQL database development files

    sudo apt-get install libmysqlclient-dev

    Now Configure the MariaDB Server by running the following command.

    sudo mysql_secure_installation

    (When you run this command, the server will show the following prompts.)

    * Enter current password for root: (Enter your SSH root user password)
    * Switch to unix_socket authentication [Y/n]: Y
    * Change the root password? [Y/n]: Y
    (It will ask you to set new MySQL root password at this step. This can be different from the SSH root user password.)
    * Remove anonymous users? [Y/n] Y
    * Disallow root login remotely? [Y/n]: N
    * Remove test database and access to it? [Y/n]: Y
    * Reload privilege tables now? [Y/n]: Y

    Now edit the MySQL config file as below.

    sudo nano /etc/mysql/my.cnf

    Add the following content to it.

    character-set-client-handshake = FALSE
    character-set-server = utf8mb4
    collation-server = utf8mb4_unicode_ci
    default-character-set = utf8mb4

    Now restart the DB server

    sudo service mariadb restart


    sudo apt install curl


    curl | bash
    source ~/.profile
    nvm install 16.15.0


    sudo apt-get install npm


    sudo npm install -g yarn

    Frappe Bench (Bench is a CLI tool to manage Frappe apps)

    sudo pip3 install frappe-bench

    Initialize Frappe Bench

    bench init --frappe-branch version-14 frappe-bench

    Switch to Frappe Bench directory

    cd frappe-bench

    Create a New Site

    (A site is required in ERPNext.)

    bench new-site demo
    bench use demo

    Now Install ERPNext

    bench get-app --branch version-14 erpnext
    bench --site demo install-app erpnext
    bench start


    Hope you find the guide helpful! Please feel free to share your feedback in the comments below.

    If you still have any issues/queries regarding how to install ERPNext on Ubuntu server, please raise a ticket at

    Also, please explore our Odoo development services & an extensive range of quality Odoo Apps.

    For any doubt, contact us at [email protected].

    Thanks for paying attention!!

    . . .

    Leave a Comment

    Your email address will not be published. Required fields are marked*

    Be the first to comment.

    Back to Top

    Message Sent!

    If you have more details or questions, you can reply to the received confirmation email.

    Back to Home