ERPNext upgrade from v13 to v14

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