https://tcbinfotech.com/upgrade-erpnext-version-15-to-16/

https://tcbinfotech.com/upgrade-erpnext-version-15-to-16/

Sejal Kumari Sejal Kumari
Dec 27, 2025 - 14:42
0

ERPNext v16 Upgrade Steps (Safe & Recommended Process)

Upgrading to ERPNext v16 is a major version change and should always be done in a planned manner. Follow these steps to ensure a smooth and safe upgrade.

Step 1: Take Complete Backup

Before starting, take full backups:

  • Database backup of all sites

  • Backup of sites folder

  • Backup of custom apps

? This is critical to avoid data loss.

Step 2: Check System Requirements

Ensure your server meets v16 requirements:

  • Updated OS packages

  • Compatible Python version

  • Latest Node.js and Yarn

  • Sufficient disk space and RAM

Step 3: Review Customizations

  • Check custom scripts and hooks

  • Review third-party apps compatibility with v16

  • Remove unused or deprecated code

Test all custom apps in a staging environment first.https://tcbinfotech.com/upgrade-erpnext-version-15-to-16/

Step 4: Update Bench

Upgrade bench to the latest version:

bench update

Make sure bench itself is stable before switching branches.

Step 5: Switch to Version 16 Branch

Switch ERPNext and Frappe to v16:

bench switch-to-branch version-16 frappe erpnext

Also update any custom apps to their compatible branches.

Step 6: Pull Latest Code

Fetch latest changes:

bench update --patch

Step 7: Run Database Migration

Apply schema and data changes:

bench migrate

Closely monitor logs for errors or warnings.

Step 8: Clear Cache & Restart

bench clear-cache bench restart

Step 9: Post-Upgrade Testing

  • Verify accounts, inventory, HR, and reports

  • Test workflows and integrations

  • Check permissions and user roles

  • Monitor logs and performance

Step 10: User Training & Go-Live

  • Inform users about UI or feature changes

  • Monitor system for a few days after go-live

Click Here To See More