Frappe Bench Setup Documentation (ERPNext v15)

✅ Step 1: System Preparation

Update and verify base packages:

sudo apt-get update
python3 -V

Install required system packages:

sudo apt-get install git
sudo apt-get install python3-dev
sudo apt-get install virtualenv
sudo apt-get install apt-transport-https curl

Create keyring directory and add MariaDB key:

sudo mkdir -p /etc/apt/keyrings
sudo curl -o /etc/apt/keyrings/mariadb-keyring.pgp 'https://mariadb.org/mariadb_release_signing_key.pgp'

Manually edit sources to add MariaDB repo:

sudo vi /etc/apt/sources.list.d/mariadb.sources

Add the official MariaDB 10.6 or above source for your Ubuntu version

Update repositories and install MariaDB:

sudo apt update
sudo apt-get install mariadb-server

Start and secure MariaDB:

sudo systemctl status mariadb
sudo mariadb
mariadb -u root -p
sudo mysql_secure_installation

Install MySQL client libraries:

sudo apt-get install libmysqlclient-dev
sudo nano /etc/mysql/my.cnf
sudo service mysql restart

sudo apt-get install redis-server

sudo apt-get install curl
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install -g yarn

sudo apt-get install xvfb libfontconfig wkhtmltopdf

sudo -H pip3 install frappe-bench

sudo apt install pipx
pipx ensurepath
pipx install frappe-bench

Confirm installation:

bench --version
pipx --version
pipx list

Add to shell profile:

nano ~/.zshrc
source ~/.zshrc
which bench
bench --version

bench get-app erpnext --branch version-15

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

Install and link honcho:

pip3 install honcho
pipx inject frappe-bench honcho

Or in virtual environment:

python3 -m venv ~/bench-env
source ~/bench-env/bin/activate
pip install honcho

cd frappe-bench
bench start

bench new-site rohit
bench use rohit
bench start

Check for processes:

sudo lsof -i :13000
sudo lsof -i :11000

Kill the process:

sudo kill -9 &lt;PID&gt;