How do I start a migration?

Who can do this

Platform Admin, Infra Ops, or QA Admin (within scope)

Migrations move tenant data between instances or apply structural changes. The Migrations page kicks one off, and the job drawer tracks per-tenant progress live.

Steps

1. Open Migrations in the sidebar.
2. Click New Migration.
3. Pick the type:
   • Instance Replace — move tenants from one instance to another.
   • Tenant Copy — duplicate a tenant to a new instance for testing.
   • Schema Migration — apply a structural change to selected tenants.
4. Fill in the type-specific fields. For instance-replace: source instance, target instance, tenants to move.
5. Choose Dry run if you want to validate without making changes.
6. Click Run.

Result

The job appears in the list with status Queued, then Running. Click the row to open the job drawer — it shows per-tenant progress, phase logs (preflight, clone, import), and artifacts produced.

If the job is a dry-run, no live data is touched; the artifacts let you preview what would happen.

Related

• How do I rerun a failed migration?
• How do I roll back a migration?