ERPNext upgrade from v13 to v14

I'm going to explain how to upgrade Frappe and ERPNext from v13 to v14.

 · 2 min read

  1. Take backup to be on safe side
  2. Make sure all apps are clean and does not contain uncommitted change

    git status

  3. Check python version ( Required Python 3.10 )

    python3 -V

  4. Upgrade python

    sudo apt install software-properties-common -y

    sudo add-apt-repository ppa:deadsnakes/ppa

    sudo apt install python3.10 python3.10-dev python3.10-distutils

    https://cloudcone.com/docs/article/how-to-install-python-3-10-on-debian-11/

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

    sudo update-alternatives --install /usr/bin/python3 python3 /opt/bench/erpnext/Python-3.10.0/python 1

  5. Confirm python version

    python3.10 --version

  6. Set default python

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

  7. Make sure python command executes python3

    sudo apt install python-is-python3

  8. Make sure python -V and python3 -V return same version

  9. Check pip3 version ( Required v22.x )

    pip3 --version

  10. Upgrade pip3

    curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

    pip3 install --upgrade pip

    sudo apt-get remove python3-apt -y

    sudo apt-get install python3-apt -y

  11. Verify pip3

    pip --version and pip3 --version

  12. Check nodejs version ( Required v16.X )

    node --version

    curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -

    sudo apt-get install -y nodejs

    https://techviewleo.com/install-nodejs-and-npm-on-debian-linux/

  13. Upgrade NPM

    npm upgrade

    sudo npm install -g npm@8.19.1

  14. Verify NPM

    npm --version

  15. Move your old python env folder to env-archive, in-case anything goes wrong, you can return to the original

    cd /opt/bench/frappe-bench/

    mv env env-archive

  16. Create new virtual env for python-3.10

    pip install virtualenv

    virtualenv --python python3.10 env

    env/bin/pip install -U pip

    env/bin/pip install -e apps/frappe -e apps/erpnext

    If fails, sudo apt install libpq-dev python3-dev

    sudo apt install libjpeg-dev zlib1g-dev

    https://stackoverflow.com/questions/35104097/how-to-install-psycopg2-with-pg-config-error https://computingforgeeks.com/how-to-install-python-on-debian-linux/

  17. Change branch to V14

    bench switch-to-branch version-14 frappe erpnext --upgrade

  18. Install and upgrade V14. Please note that monolith is broken on V14 and you must install payments and hrms module in addition to ERPNext

    bench get-app payments

    bench get-app hrms

    bench update --reset

    bench --site *sitename* install-app hrms

    bench --site *sitename* install-app payments

    bench --site *sitename* migrate

  19. Upgrade SSL sudo certbot --nginx

https://cloud.erpgulf.com/blog/support-forum/erpnext-upgrade-from-version-13-to-version-14-ubnutu


No comments yet.

Add a comment
Ctrl+Enter to add comment