How to Install Frappe/ERPNext v15 on Ubuntu 24.04 LTS – Step-by-Step Guide

Struggling to set up Frappe/ERPNext on Ubuntu 24.04 LTS? Many users face issues with dependencies, configurations, and installation errors. This guide simplifies the process, providing clear, step-by-step instructions to ensure a hassle-free setup.

Whether you’re new to ERP systems or upgrading to v15, follow this guide to install Frappe/ERPNext seamlessly.

Pre-requisites

Ensure that your system meets the following requirements before proceeding:

• Python 3.11+ (Ubuntu 24.04 comes with Python 3.12 by default)
• Node.js 18+
• Redis 5 (for caching and real-time updates)
• MariaDB 10.3.x / PostgreSQL 9.5.x (for database-driven applications)
• Yarn 1.12+ (JavaScript dependency manager)
• Pip 20+ (Python dependency manager)
• wkhtmltopdf (0.12.5 with patched Qt) (for PDF generation)
• Cron (for scheduled jobs, backups, etc.)
• NGINX (for proxying multi-tenant sites in production)

Note: Ubuntu 24.04 default versions:

• Python: 3.12
• MariaDB: 10.11 (may show compatibility warnings)

Step-by-Step Installation

Step 1: Install Git

sudo apt-get install git

Step 2: Install Python Development Tools

sudo apt-get install python3-dev

Step 3: Install Setuptools and Pip

sudo apt-get install python3-setuptools python3-pip

Step 4: Install Virtual Environment

sudo apt install python3.12-venv

Step 5: Install MariaDB

sudo apt-get install software-properties-common sudo apt install mariadb-server sudo systemctl status mariadb sudo mysql_secure_installation

Follow the prompts to set up the root password and configure security settings.

Step 6: Install MySQL Development Files

sudo apt-get install libmysqlclient-dev

Step 7: Configure MariaDB

Edit MariaDB configuration file:

sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf

Add the following settings

[server] user = mysql pid-file = /run/mysqld/mysqld.pid socket = /run/mysqld/mysqld.sock basedir = /usr datadir = /var/lib/mysql tmpdir = /tmp lc-messages-dir = /usr/share/mysql bind-address = 127.0.0.1 query_cache_size = 16M log_error = /var/log/mysql/error.log [mysqld] innodb-file-format=barracuda innodb-file-per-table=1 innodb-large-prefix=1 character-set-client-handshake = FALSE character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci [mysql] default-character-set = utf8mb4

Save and exit (Ctrl+X, then Y, then Enter). Restart MariaDB:

sudo service mysql restart

Step 8: Install Redis

sudo apt-get install redis-server 

Step 9: Install Node.js 18

sudo apt install curl curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash source ~/.profile nvm install 18

Step 10: Install Yarn

sudo apt-get install npm sudo npm install -g yarn

Step 11: Install wkhtmltopdf

sudo apt-get install xvfb libfontconfig wkhtmltopdf

Step 12: Install Frappe Bench

sudo -H pip3 install frappe-bench --break-system-packages bench --version

Step 13: Initialize Frappe Bench

bench init frappe-bench --frappe-branch version-15 cd frappe-bench/ bench start

Step 14: Create a Site in Frappe Bench

bench new-site localhost

Open http://localhost:8000 in your browser to access the site.

Step 15: Install ERPNext

bench get-app erpnext --branch version-15 bench --site localhost install-app erpnext bench start

Conclusion

Congratulations! You have successfully installed Frappe/ERPNext Version 15 on Ubuntu 24.04 LTS. You can now start configuring your ERPNext instance to suit your business needs.

If you encounter any difficulties during the installation process, feel free to contact us. Our ERPNext implementation services are designed to help you seamlessly set up and optimize Frappe/ERPNext. We’re here to resolve any challenges and ensure a smooth implementation for your business.

FAQ

1. What if I face compatibility issues with MariaDB 10.11?

MariaDB 10.11 is newer than the recommended 10.3.x. If you encounter issues, consider downgrading to MariaDB 10.6 or using PostgreSQL as an alternative.

2. How do I access ERPNext after installation?

Simply navigate to http://dcode.com:8000 in your browser and log in using the admin credentials.

3. How do I keep my installation updated?

Run the following commands periodically to update your setup:

bench update