How to install ERPNext v15 on Ubuntu 22.04 or 24.04: a step-by-step tutorial

Short answer: ERPNext v15 needs Python 3.10 or newer, Node.js 18 or newer, MariaDB 10.6.6 or newer, Redis and wkhtmltopdf. On a fresh Ubuntu server, create a non-root user, install those dependencies, install Frappe Bench, run bench init --frappe-branch version-15, create a site, then add ERPNext with bench get-app --branch version-15 erpnext. This guide gives every command in order, plus production setup with Nginx and free SSL.

Version 15 is a stable, widely used release. Frappe's Supported Versions page plans support for it until the end of 2027. If you're starting a brand-new project today, also look at our ERPNext v16 installation guide, since v16 is supported for longer.

ERPNext v15 requirements

ComponentVersion for v15Notes
Operating systemUbuntu 22.04 or 24.04 (64-bit)A fresh server is best
Python3.10 or newerFrappe's own v15 tests run on 3.10; the package allows up to 3.14
Node.js18 or newerFrappe's v15 tests use Node 18
MariaDB10.6.6 or newerUbuntu 22.04 ships 10.6, Ubuntu 24.04 ships 10.11
Redis6 or newerUsed for cache and background jobs
Yarn1.12 or newerBuilds the front-end assets
wkhtmltopdf0.12.6 (patched Qt)Needed for PDF print formats

For a small company, we suggest at least 2 vCPU, 4 GB RAM and 40 GB SSD storage. More users, more transactions or extra apps need more.

Commands were checked against the official Frappe documentation and the version branches on GitHub. Package versions change over time, so if a command fails, check the linked sources for the latest instructions.

Step 1: Update the server and create a user

Don't run Bench as root. Create a separate user (here called frappe) with sudo rights:

sudo apt update && sudo apt upgrade -y
sudo adduser frappe
sudo usermod -aG sudo frappe
su - frappe

Step 2: Install system packages

sudo apt install -y git curl cron software-properties-common \
  python3-dev python3-venv python3-pip \
  redis-server xvfb libfontconfig libmysqlclient-dev pkg-config

Check Python: python3 --version should show 3.10 (Ubuntu 22.04) or 3.12 (Ubuntu 24.04). Both work for v15.

Step 3: Install and configure MariaDB

sudo apt install -y mariadb-server mariadb-client
sudo mariadb-secure-installation

Set a strong root password when asked and remember it; Bench needs it to create site databases. Then open the MariaDB config:

sudo nano /etc/mysql/my.cnf

Add these lines at the end, save, and restart MariaDB:

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4
sudo systemctl restart mariadb

Step 4: Install Node.js 18 and Yarn

Use nvm, so you can switch Node versions later without breaking the system:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 18
npm install -g yarn
node --version
yarn --version

Step 5: Install wkhtmltopdf

ERPNext v15 uses wkhtmltopdf to create PDFs. Install the build with patched Qt from the official packaging project (this is the amd64 build; use the arm64 file on ARM servers):

wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox_0.12.6.1-2.jammy_amd64.deb
sudo apt install -y ./wkhtmltox_0.12.6.1-2.jammy_amd64.deb
wkhtmltopdf --version

Step 6: Install Frappe Bench

Ubuntu 24.04 blocks system-wide pip install, so install Bench with uv. This works on 22.04 too:

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
uv tool install frappe-bench
bench --version

Step 7: Create the bench with Frappe v15

cd ~
bench init --frappe-branch version-15 frappe-bench
cd frappe-bench
chmod -R o+rx /home/frappe

This downloads Frappe Framework v15, creates a Python environment and builds assets. It can take 5–15 minutes.

Step 8: Create a site and install ERPNext

Use your real domain as the site name if you plan to go live (for example erp.yourdomain.com):

bench new-site erp.yourdomain.com
bench get-app --branch version-15 erpnext
bench --site erp.yourdomain.com install-app erpnext

new-site asks for the MariaDB root password and an Administrator password for ERPNext. Need HR and payroll? Add Frappe HR the same way:

bench get-app --branch version-15 hrms
bench --site erp.yourdomain.com install-app hrms

To test quickly, run bench start and open http://your-server-ip:8000. Stop it with Ctrl+C before setting up production.

Step 9: Production setup (Nginx and Supervisor)

bench --site erp.yourdomain.com enable-scheduler
bench --site erp.yourdomain.com set-maintenance-mode off
sudo env "PATH=$PATH" bench setup production frappe
bench setup nginx
sudo supervisorctl restart all
sudo supervisorctl status

bench setup production configures Supervisor (keeps ERPNext running) and Nginx (serves it on port 80). All processes in supervisorctl status should show RUNNING.

Step 10: Domain and free SSL

Point an A record for your domain to the server's IP, then:

bench config dns_multitenant on
bench setup nginx
sudo systemctl reload nginx
sudo snap install --classic certbot
sudo certbot --nginx -d erp.yourdomain.com

Certbot sets up HTTPS and renews the certificate automatically.

Step 11: Backups and updates

# Backup database and files
bench --site erp.yourdomain.com backup --with-files

# Update to the latest v15 release (take a backup first)
bench update

Keep backups off the server as well, for example in cloud storage. Always test updates on a copy of your site before updating a live system.

Common errors and fixes

ErrorLikely causeFix
"externally-managed-environment" when installing benchUbuntu 24.04 blocks system pipInstall Bench with uv tool install frappe-bench
Access denied for user 'root'@'localhost' during new-siteWrong MariaDB root passwordRe-run sudo mariadb-secure-installation and use that password
Strange characters or emoji errorsMariaDB charset not setAdd the utf8mb4 settings from Step 3 and restart MariaDB
Assets don't load (unstyled page)Build failed or permissionsRun bench build and chmod -R o+rx /home/frappe
PDF prints blank or without stylesWrong wkhtmltopdf buildInstall the 0.12.6.1 patched-Qt package from Step 5
Background jobs or emails not runningScheduler disabled or Redis stoppedRun enable-scheduler and check sudo supervisorctl status

Frequently asked questions

Which Python version does ERPNext v15 need?

Python 3.10 or newer. Frappe's v15 test setup uses Python 3.10, and the v15 package allows versions up to 3.14. Ubuntu 22.04 (Python 3.10) and Ubuntu 24.04 (Python 3.12) both work.

Which Node.js version does ERPNext v15 need?

Node.js 18 or newer. Frappe's own v15 tests run on Node 18.

Can I install ERPNext v15 on Ubuntu 24.04?

Yes. The main difference is that Ubuntu 24.04 blocks system-wide pip installs, so install Frappe Bench with uv as shown in Step 6.

How long is ERPNext v15 supported?

Frappe's Supported Versions page lists the planned end of life for v15 as the end of 2027. New projects may prefer v16, which is planned to be supported until the end of 2029.

How much RAM does ERPNext need?

For a small company we suggest at least 4 GB RAM with 2 vCPU. More users, heavy reports or extra apps need more.

Sources

Don't want to manage servers? Our ERPNext implementation service handles installation, setup, data migration and training.

Vivek Choudhary
Hi, I'm Vivek Choudhary

I build websites, SEO, ERPNext systems and mobile apps for Indian businesses from Mumbai, including ERPWork, my free ERPNext app for Android. Articles are drafted with the help of AI tools, then checked and edited by me. If something here doesn't fit your situation, message me on WhatsApp and I'll reply personally.

Need help with this?

Get honest advice and a clear quote from our team. No obligation.