Custom Migrator
Push Frappe customisations to a git repo from the desk.
Set up
Install, configure Git, verify in 5 minutes.
Export to Git
Pick items, preview the diff, push a branch.
Settings reference
Every Migrator Settings field explained.
Migration Log
Action and status enums; the audit trail.
Troubleshooting
Symptom → cause → fix.
What it moves
Custom Fields, Property Setters, Client Scripts, Server Scripts, Workflows, Workflow States, custom DocTypes, Notifications. You can add more DocType types to track in Settings.
It does not move business records (Customers, Invoices) or app code. Those belong in your data and your repo respectively.
Who can use it
| Role | Open the page, export, view logs | Edit Settings |
|---|---|---|
| System Manager | ✓ | ✓ |
| Hydra Admin | ✓ | ✓ |
| Hydra User | ✓ | ✗ |
NOTE
Hydra User is functional-only access. They can run migrations but can't touch the Git PAT or target app config.
Quick start
Install the app
bench get-app + install-app. Eight DocTypes are tracked out of the box.
Configure Migrator Settings
PAT, remote name, target app, base branch. Click Test Connection.
Export your first change
Tick items → preview diff → push branch → open PR.