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
| Component | Version for v15 | Notes |
|---|---|---|
| Operating system | Ubuntu 22.04 or 24.04 (64-bit) | A fresh server is best |
| Python | 3.10 or newer | Frappe's own v15 tests run on 3.10; the package allows up to 3.14 |
| Node.js | 18 or newer | Frappe's v15 tests use Node 18 |
| MariaDB | 10.6.6 or newer | Ubuntu 22.04 ships 10.6, Ubuntu 24.04 ships 10.11 |
| Redis | 6 or newer | Used for cache and background jobs |
| Yarn | 1.12 or newer | Builds the front-end assets |
| wkhtmltopdf | 0.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
| Error | Likely cause | Fix |
|---|---|---|
| "externally-managed-environment" when installing bench | Ubuntu 24.04 blocks system pip | Install Bench with uv tool install frappe-bench |
| Access denied for user 'root'@'localhost' during new-site | Wrong MariaDB root password | Re-run sudo mariadb-secure-installation and use that password |
| Strange characters or emoji errors | MariaDB charset not set | Add the utf8mb4 settings from Step 3 and restart MariaDB |
| Assets don't load (unstyled page) | Build failed or permissions | Run bench build and chmod -R o+rx /home/frappe |
| PDF prints blank or without styles | Wrong wkhtmltopdf build | Install the 0.12.6.1 patched-Qt package from Step 5 |
| Background jobs or emails not running | Scheduler disabled or Redis stopped | Run 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
- Frappe Framework documentation: Installation
- frappe/frappe version-15 branch (pyproject.toml, package.json, CI tests)
- ERPNext wiki: Supported Versions
- wkhtmltopdf packaging release 0.12.6.1-2
Don't want to manage servers? Our ERPNext implementation service handles installation, setup, data migration and training.
Need help with this?
Get honest advice and a clear quote from our team. No obligation.

