Skip to main content
Apragya AIFree quotation builderQuotation builderQuote builderno signup
Migration guide

How to Migrate From ERPNext to Apragya Without Rebuilding Your Customisations

For businesses running ERPNext, self-hosted or managed: move masters, balances and stock at a period start, and replace custom scripts with settings and AI agents.

An engineer taking a folder out of an old server cabinet on a factory floor

Teams that migrate from ERPNext rarely leave because of missing modules. ERPNext is a capable open-source ERP with accounting, stock, manufacturing and HR, and it serves many Indian firms well, especially those with an in-house developer who enjoys maintaining it.

The trouble starts when that developer leaves. Custom fields, server scripts and patched reports have to survive every upgrade, and self-hosting means someone owns backups, security and uptime.

This guide covers what to export from ERPNext, how to handle customisations, an illustrative move at a Ludhiana cycle parts maker, and who should stay.

How to migrate from ERPNext: the short answer

Export lists and reports from ERPNext as CSV or Excel: chart of accounts, customers, suppliers, items, bills of material, stock balance per warehouse, a closing trial balance, and outstanding invoices and bills. Include the values of any custom fields.

Before importing, list every customisation and decide its fate. In practice most server scripts become configured approvals or AI agents, custom fields become custom fields, and a few are retired. Then import in dependency order and agree totals at a financial year or quarter start.

  1. Export masters, BOMs, stock and open items.
  2. Audit customisations and decide each one.
  3. Import accounts, parties and items with custom fields.
  4. Load BOMs, opening stock and open items.
  5. Agree the trial balance and switch.

What changes after the move

Apragya

  • Updates arrive without custom code to retest
  • Hosted, with VPC or on-premise options
  • Reports and fields configured by an admin
  • AI agents on records, with human review

An illustrative move at a Ludhiana cycle parts maker

Take an illustrative maker of cycle chains and sprockets, 220 people, running ERPNext on its own server with fourteen custom fields and six server scripts. They moved at the start of the financial year.

What happened to each customisation

  • Custom fieldsRecreated as custom fields on the same records.Done
  • Credit limit scriptBecame a configured approval above the limit.Done
  • BOM costing reportCovered by manufacturing analytics.Done
  • Dispatch alertAn agent now flags late dispatches for review.Done
  • Old print formatsInvoice layout matched to the old one.Checked
  • Scrap valuation hackUnder review with the accountant.Pending
Most scripts turned out to be settings in disguise.

Five of the six scripts became settings or an agent, and the sixth was left for the accountant to decide. Opening stock came in per warehouse, bills of material were rebuilt for the forty items still in production, and the old server stayed up read-only for the audit.

A pegboard of six tools, five tagged green and one amber
Five of the six custom scripts became settings or an agent. One waits for the accountant.

How the ERPNext data migration works

Step 1 of 5

Export

Lists and reports downloaded as CSV or Excel.

  1. Export: Lists and reports downloaded as CSV or Excel.
  2. Customisation audit: Every custom field, script and report listed.
  3. Preview and map: Columns matched to Apragya fields, custom fields added.
  4. Import: Accounts, parties, items, BOMs, then opening stock.
  5. Open items: Unpaid invoices and bills, then the trial balance agreed.

ERPNext alternative: when a hosted platform fits better

ERPNext rewards teams that want to own and extend their system. Apragya suits teams that want to configure rather than code, with AI agents and Indian compliance maintained for them.

ERPNext and Apragya

FeatureERPNextApragya
LicenceOpen source; hosting options varySubscription with published plans
Custom logicScripts and custom appsConfiguration and AI agents
HostingSelf-hosted or managedHosted, VPC or on-premise
Indian complianceAvailable through the product and appsGST, e-invoice, TDS and payroll built in
AI agentsCheck the project's current featuresAgents on records, with human review

Checked against public information on 16 September 2026.

What you stop maintaining

Upgrade testing

No custom scripts to retest after each release.

Servers

No self-run database or backups to watch.

Rules as settings

Approvals, fields and numbering configured by admins.

Agents instead of scripts

Checks run as agents and wait for human review.

Audit log

User, role, action, record, time and IP.

One record

Every app reads the same party, item and employee.

See the ERPNext comparison, bills of material and open-source ERP vs SaaS ERP.

Getting started

  1. List every custom field, script, report and print format.
  2. Decide for each: setting, custom field, agent, or retire.
  3. Export masters, BOMs, stock and open items at a period start.
  4. Import and agree the trial balance and stock.
  5. Keep the ERPNext server read-only for history.

Stay on ERPNext if you have a developer who owns it happily and your customisations are the heart of the business.

What it costs to start

Free
Up to 3 users
CRM, HR and Vendor Onboarding
INR 3,999
Starter, a month
Up to 10 users, CRM and HR plus a choice of apps
INR 7,999
Pro, a month
Up to 25 users and every enterprise app

ERPNext migration, answered

Can Apragya read the ERPNext database?
The Postgres connector can query PostgreSQL. Many ERPNext sites use MariaDB, so exports are the usual route.
What about our custom fields?
Records in Apragya support custom fields, so most can be recreated and imported with their values.
Do we move all transactions?
Usually masters, balances, stock and open items. Keep ERPNext readable for history.
Can server scripts be replaced?
Most become configured approvals or AI agents with review. List them first and decide one by one.
What does it cost to start?
The free plan covers up to 3 users with CRM, HR and Vendor Onboarding and 1,000 AI Credits a month. Starter is INR 3,999 a month for up to 10 users, with CRM and HR plus a choice of apps such as Sales and POS, Inventory, Payroll, Purchase and Payables, Support and Manufacturing. Pro is INR 7,999 a month for up to 25 users with every enterprise app, including Finance and Accounting, plus 5,000 AI Credits, single sign-on and audit logs.

Keep the rules, lose the upkeep

Audit your customisations and move at the next period start.