[Tutorial][beta] Installing ERPNext-15 on Local Setup: A Step-by-Step Guide


ERPNext is an open-source ERP system that helps businesses manage their operations efficiently. This guide will walk you through the process of installing ERPNext version 15 on your local setup.


Before you begin, ensure you have the following prerequisites in place:

  1. Operating System: Linux (Ubuntu 20+ recommended)
  2. Python: Version 3.10.12 or higher
  3. Node.js: Version 18.x or higher
  4. MariaDB: Version 10.6 or higher
  5. Redis: Latest version
  6. Docker: Latest version

Step 1
Clone the frappe_docker

git clone https://github.com/frappe/frappe_docker.git

Rename the folder frappe_docker to frappe_docker_15_beta

There is the reason behind the name change if you already have the ERPNext setup in local and it was in docker means the folder name will get conflicted. that’s why

move inside the folder

cd  frappe_docker_15_beta

Run these commands

cp -R devcontainer-example .devcontainer
cp -R development/vscode-example development/.vscode

Open the Project in VS-Code

code .
  • Launch the command, from Command Palette (Ctrl + Shift + P) Remote-Containers: Reopen in Container. You can also click in the bottom left corner to access the remote container menu.

It will take normally 3-5 minutes to open on first time. after the VS-Code get setup. you are good to go.

Step 2
Install Frappe Bench

nvm use v18
PYENV_VERSION=3.10.12 bench init --skip-redis-config-generation --frappe-branch version-15-beta frappe-bench
cd frappe-bench

Step 3
Setup hosts
We need to tell bench to use the right containers instead of localhost. Run the following commands inside the container:

bench set-config -g db_host mariadb
bench set-config -g redis_cache redis://redis-cache:6379
bench set-config -g redis_queue redis://redis-queue:6379
bench set-config -g redis_socketio redis://redis-socketio:6379

Step 4
Create site
DB Password: 123
Admin Password: admin

bench new-site development-15-beta.localhost --mariadb-root-password 123 --admin-password admin --no-mariadb-socket

Step 5
Set bench developer mode on the new site

bench --site development-15-beta.localhost set-config developer_mode 1
bench --site development-15-beta.localhost clear-cache

Step 6
Install erpnext

bench get-app --branch version-15-beta --resolve-deps erpnext
bench --site development-15-beta.localhost install-app erpnext

Step 7
Install hrms

bench get-app --branch version-15-beta hrms
bench --site development-15-beta.localhost install-app hrms


Before start the bench if you want to install other apps like payments or india-compliance you can install if you want. thank you

Step 8
Start the site Go To Site

bench start

For Production setup or any queries feel free to contact me thank you


Github : Antony-M1 · GitHub
Linkedin : Antony


do you have OVA file with Ubuntu 23 installed?

No idea

You can try at the command line in the running virtual machine:

cat /etc/os-release

It should give you information about the type of linux running in it.