How to install ERPNext v16 on Ubuntu 24.04 or Debian 13: a step-by-step tutorial

Short answer: ERPNext v16 needs a newer stack than v15: Python 3.14, Node.js 24 and MariaDB 11.8, plus Redis 6+, Yarn 1.22+ and pip 25.3+. Frappe recommends Debian 13+ or Ubuntu 24.04+. Install Python with uv, Node with nvm, MariaDB 11.8 (from MariaDB's own repository on Ubuntu 24.04), then install Frappe Bench with uv tool install frappe-bench and run bench init --frappe-branch version-16.

The most common mistake is following an old v15 guide: v16 fails on Python 3.11 or 3.12 and on Node 22 or older. Frappe's Supported Versions page plans support for v16 until the end of 2029, so it's a good choice for new installations. Using v15? See our ERPNext v15 installation guide.

ERPNext v16 requirements

Componentv15v16
Python3.10+3.14 (the package requires 3.14.x)
Node.js18+24
MariaDB10.6.6+11.8
Redis / Valkey66+
Yarn1.12+1.22+
pip20+25.3+
Recommended OSUbuntu 22.04 / 24.04Debian 13+ or Ubuntu 24.04+

These match the official installation docs and the versions Frappe's own v16 tests run on (Python 3.14, Node 24, MariaDB 11.8). For a small company, start with at least 2 vCPU, 4 GB RAM and 40 GB SSD.

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

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 \
  redis-server libmariadb-dev pkg-config xvfb libfontconfig

Step 3: Install MariaDB 11.8

On Debian 13, the default package is MariaDB 11.8:

sudo apt install -y mariadb-server mariadb-client

On Ubuntu 24.04, the default package is 10.11, so add MariaDB's official repository and pin version 11.8 (without the version flag, the script picks a newer release):

curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --mariadb-server-version="mariadb-11.8"
sudo apt update
sudo apt install -y mariadb-server mariadb-client
mariadb --version

Secure it and set a root password (Bench needs it):

sudo mariadb-secure-installation

Then add the character set settings to /etc/mysql/my.cnf and restart:

[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 Python 3.14 with uv

Ubuntu 24.04 ships Python 3.12, which v16 can't use. uv installs Python 3.14 for your user without touching the system Python:

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
uv python install 3.14 --default
python3.14 --version

Step 5: Install Node.js 24 and Yarn

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

Node 22 or older will fail when Bench builds the front-end assets.

Step 6: Install Frappe Bench

uv tool install frappe-bench
bench --version

Step 7: Create the bench with Frappe v16

cd ~
bench init --frappe-branch version-16 --python python3.14 frappe-bench
cd frappe-bench
chmod -R o+rx /home/frappe

The --python flag makes sure the bench environment uses Python 3.14 and not the system Python.

Step 8: Create a site and install ERPNext

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

Optional, for HR and payroll:

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

Quick test: run bench start and open http://your-server-ip:8000. Stop it with Ctrl+C before the production setup.

Step 9: PDF printing

The current Frappe docs say PDF generation uses Chromium, which Bench downloads. You can download it in advance:

bench setup-chrome

Many community v16 guides also install wkhtmltopdf 0.12.6.1 (see our v15 guide, Step 5). If your print formats still rely on it, install it too.

Step 10: Production setup, domain and SSL

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 config dns_multitenant on
bench setup nginx
sudo systemctl reload nginx
sudo supervisorctl status
sudo snap install --classic certbot
sudo certbot --nginx -d erp.yourdomain.com

Point your domain's A record to the server before running Certbot.

Step 11: Keep it updated

bench --site erp.yourdomain.com backup --with-files
bench update
bench version

bench update pulls the latest v16 release of every app on the bench, runs database migrations and rebuilds assets. Frappe ships frequent v16 updates, including the large v16.50 update.

Upgrading from v15 to v16

An upgrade isn't just bench update: v16 needs Python 3.14, Node 24 and MariaDB 11.8, so the bench's Python environment must be rebuilt on 3.14. The safest path is to set up a fresh v16 bench (as above), restore a backup of your v15 site into it, run bench --site yoursite migrate, and test everything, including custom apps, before switching users over. Never test an upgrade on your only live copy.

Common errors and fixes

ErrorLikely causeFix
SyntaxError during bench init or installBench environment uses Python 3.12 or olderInstall Python 3.14 with uv and run bench init with --python python3.14
Asset build failsNode 22 or oldernvm install 24, then bench build
Database errors on new-siteMariaDB 10.x installed from Ubuntu's default repoInstall MariaDB 11.8 from MariaDB's repository (Step 3)
"Could not find Default Currency" during install-appSetup data incompleteRe-run the install and complete the setup wizard; check the Frappe Forum for your exact error
Processes not RUNNING in supervisorProduction setup incompleteRe-run bench setup production and sudo supervisorctl restart all

Frequently asked questions

Which Python version does ERPNext v16 need?

Python 3.14. The v16 package requires Python 3.14.x, and Frappe's own v16 tests run on Python 3.14. Older Python versions fail with syntax errors.

Which Node.js and MariaDB versions does ERPNext v16 need?

Node.js 24 and MariaDB 11.8, according to the official Frappe installation documentation and Frappe's v16 test setup.

Can I install ERPNext v16 on Ubuntu 22.04?

Frappe recommends Debian 13+ or Ubuntu 24.04+ to avoid package problems. Use Ubuntu 24.04 or Debian 13 for a new v16 server.

How long will ERPNext v16 be supported?

Frappe's Supported Versions page lists the planned end of life for v16 as the end of 2029.

Is v16 stable enough for production?

Yes. v16 was released in January 2026 and has received many updates since. As with any ERP, test your own workflows, custom apps and third-party apps on a staging copy before going live.

Sources

Need ERPNext v16 installed, configured for GST and your workflows, and supported? See our ERPNext implementation service or Frappe development for custom apps.

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.