Upgrade ERPNext 13 to ERPNext 14


I have a need to upgrade production version of ERPNext 13 to ERPNext 14.

What is the best way to upgrade without any data loss?


Yogi Yang


Here are the general steps to upgrade from ERPNext version 13 to 14:

  1. Backup your current ERPNext database and files:

    bench backup

    This will create a backup file in the sites/site_name/private/backups directory.

  2. Update your ERPNext installation:

    bench update --patch

    This will update your ERPNext installation to the latest version of version 13.

  3. Switch to the version-14 branch:

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

    This will switch your ERPNext installation to the version-14 branch and upgrade your Frappe and ERPNext apps.

  4. Migrate your site to version 14:

    bench --site site_name migrate

    This will update your site’s database schema and data to match the requirements of version 14.

  5. Reinstall your custom apps:

    bench --site site_name reinstall

    This will reinstall any custom apps you have installed.

  6. Test your ERPNext installation:Make sure everything is working as expected by testing all the features and workflows of your ERPNext installation.

Hope this will help you out.

Thank you.


Is it Ubuntu , then there is a very detailed documentation that everyone follows here

1 Like