ERPNext Upgrade Guide: Moving Between Major Versions Safely
How to upgrade ERPNext between major versions: inventory apps, handle features moved to separate apps, test on staging and run the production upgrade.
ERP platform · ERPNext
Overview
Both are data and code problems more than software problems. We profile and clean data before it moves, script every load so it can be rehearsed, and reconcile the results to the last unit of stock and the last rupee, dollar or pound on the trial balance.
ERP Builders is an independent ERPNext services company and is not affiliated with or endorsed by Frappe Technologies. “ERPNext” and “Frappe” are trademarks of Frappe Technologies Pvt. Ltd.
01
We migrate master data, open documents and opening balances, and usually leave closed history in the old system or an archive that stays searchable. Bringing years of history into ERPNext rarely justifies the cost and risk.
Ledgers mapped to an ERPNext chart of accounts, GST details carried across, stock items and godowns mapped to items and warehouses.
Customers, suppliers, items and open invoices, with stock and costing moved into a real perpetual inventory for the first time.
Products, BOMs, price lists, open orders and balances extracted from the source database and transformed into ERPNext DocTypes.
02
ERPNext major versions change data structures and move features between apps — HR and payroll moved into Frappe HR, and regional features into apps such as India Compliance. An upgrade has to account for those moves as well as for your own custom apps and scripts.
We upgrade a copy of production on staging first, step through intermediate versions where required, fix custom code against the new version, and have your key users test before scheduling the production upgrade.
Process
Source data and customisations are inventoried and assessed for quality, volume and risk.
Field mappings agreed with your team and transformation scripts written so every load is repeatable.
At least two full rehearsals on staging, reconciled against source reports and the general ledger.
A timed cutover runbook, final load, sign-off on reconciliations and hypercare afterwards.
Related
Insights
How to upgrade ERPNext between major versions: inventory apps, handle features moved to separate apps, test on staging and run the production upgrade.
How ERPNext manufacturing works: BOMs, workstations, production plans, work orders, job cards, backflushing, subcontracting, quality and costing.
How to move from Tally to ERPNext: mapping ledgers, GST details, stock items and godowns, loading opening balances, picking a cutover date and reconciling.
FAQ
It is possible, but rarely worthwhile. We normally migrate masters, open items and opening balances at a period boundary, and keep Tally available read-only for historical reference and audits.
Usually the database must pass through intermediate major versions so each version's patches run. We plan the path, test it on a copy, and fix custom apps at each step.
Typically a weekend for a migration to ERPNext and a few hours for a version upgrade. Rehearsals tell us the real figure before we commit to a date.
Comparisons
Next step
Share what you are migrating from and we will outline the path, risks and effort.