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
| Component | v15 | v16 |
|---|---|---|
| Python | 3.10+ | 3.14 (the package requires 3.14.x) |
| Node.js | 18+ | 24 |
| MariaDB | 10.6.6+ | 11.8 |
| Redis / Valkey | 6 | 6+ |
| Yarn | 1.12+ | 1.22+ |
| pip | 20+ | 25.3+ |
| Recommended OS | Ubuntu 22.04 / 24.04 | Debian 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
| Error | Likely cause | Fix |
|---|---|---|
SyntaxError during bench init or install | Bench environment uses Python 3.12 or older | Install Python 3.14 with uv and run bench init with --python python3.14 |
| Asset build fails | Node 22 or older | nvm install 24, then bench build |
| Database errors on new-site | MariaDB 10.x installed from Ubuntu's default repo | Install MariaDB 11.8 from MariaDB's repository (Step 3) |
| "Could not find Default Currency" during install-app | Setup data incomplete | Re-run the install and complete the setup wizard; check the Frappe Forum for your exact error |
| Processes not RUNNING in supervisor | Production setup incomplete | Re-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
- Frappe Framework documentation: Installation (v16/develop prerequisites)
- frappe/frappe version-16 branch (Python and Node requirements, CI tests)
- Frappe Forum: Guide to installing ERPNext v16 on Ubuntu 24.04
- ERPNext wiki: Supported Versions
- MariaDB: Package repository setup
Need ERPNext v16 installed, configured for GST and your workflows, and supported? See our ERPNext implementation service or Frappe development for custom apps.
Need help with this?
Get honest advice and a clear quote from our team. No obligation.

