Frapp ERPNext upgrade from V14 to Version 15 - Ubnutu

Frapp ERPNext upgrade from V14 to V15 - Ubnutu

 · 2 min read

Bundesautobahn 15 - Wikipedia

( commands are in blue letters )

Note: You need NOT upgrade Ubuntu from 20+ to 22+ for upgrading ERPNext to Version 15. EPRNext and Frappe 15 works both on Ubuntu 20+ and 22+ )

1- Take backup. ( Should I explain that !!! )

( Taking sql backup directly - mysqldump -u username -p db_name > backup_db_dump.sql )

2- Make sure you don't have any customization those are not committed.

cd /opt/bench/frappe-bench/apps/erpnext

git status

Refresh index: 100% (6953/6953), done.

On branch version-14

Your branch is up to date with 'upstream/version-14'.

nothing to commit, working tree clean


git status

On branch version-14

Your branch is up to date with 'upstream/version-14'.

nothing to commit, working tree clean

3-Check python version

python3 -V

Python 3.8.10 ( needs to be upgraded to 3.10 )

4-check node version.

node --version

v12.22.12 ( needs to be upgraded to v20 ( Minimum)

5-Check pip or pip3 version

pip3 --version

20.2 ( needs to be upgrade to 22.x )

6- Upgrade python ( IF required )

sudo apt install software-properties-common

sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt install python3.10

sudo update-alternatives --remove python3 /usr/bin/python3.8

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

Confirm python version upgrade by

python3.10 --version

Python 3.10.6

python3 -V

Python 3.10.6

7 - Upgrade PIP ( if required )

curl -sS | python3.10

pip3 install --upgrade pip

sudo apt-get remove python3-apt -y

sudo apt-get install python3-apt -y

pip install html5lib

python3.10 -m pip install --upgrade pip

check PIP verison and confirm.

pip --version

pip 22.2.2 from /home/erpnext/.local/lib/python3.10/site-packages/pip (python 3.10)

pip3 --version

pip 22.2.2 from /home/erpnext/.local/lib/python3.10/site-packages/pip (python 3.10)

8- Upgrade Node

--------------Node 21 installation ---------

sudo apt install -y ca-certificates curl gnupg

sudo mkdir -p /etc/apt/keyrings

curl -fsSL | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

sudo apt update

sudo apt install nodejs -y

Check node version and confirm

node --version


9- Upgrade NPM ( If required )

npm upgrade

sudo npm install 16

sudo npm install -g npm@8.19.1

check npm version and confirm

npm --version

( Need minimum 10 )


12- Change git upstream from V14 to V15

bench switch-to-branch version-15 frappe erpnext --upgrade ( And whatever apps you want to upgrade like hrms, payments etc )

source env/bin/activate

pip3 install pydantic

pip3 install --upgrade redis

bench update --requirements

bench --site migrate

bench update

sudo service supervisor restart

Check the version now

bench version

A full installation document published here

Also we published a six part series of Frappe installation with all conceptual details here


Note 1: *

If you face problem with nginx because of log type error ( log type main not found or something like that )

vvim /etc/nginx/nginx.conf and add following on http section.

log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"';


Often you may need to recreate env file

1- delete env directory from the frappe-bench directory

2- run: bench setup env

3- run: bench setup requirements

4- go to common_site_config.json and remove “maintenance mode”:1


Map Python with new version

vim ~/.bashrc

alias python=python3.11

alias python3=python3.11

alias python3.8=python3.11


sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

use it other folder and copy env to original frappe-bench sudo pip3 install frappe-bench  

Upgrade to python 3.10 help

Team ERPGulf

The team behind ERPGulf blogs here, expresses their thoughts, shares the experience, often show the frustrations. Contact us on

No comments yet

No comments yet. Start a new discussion.

Add Comment