Site Migration
The Site Migration feature allows you to move your Frappe Cloud site between benches, servers, and regions with minimal manual effort. Whether you’re upgrading your infrastructure, changing deployment locations, or simply reorganizing your environment, Site Migration provides a streamlined way to relocate your site.
Supported Migration Types
Frappe Cloud supports the following migration options:
- In-Place Migration
Runs thebench migratecommand on your existing site without moving it to another bench or server. - Move Site from Shared to Private Bench
Transfer your site from a shared bench to a private shared or dedicated bench for greater control and customization. - Move Site to a Different Server or Bench
Relocate your site to another server, either on an existing bench or on a newly created one. - Move Site to a Different Region
Migrate your site to a server hosted in a different geographic region to improve performance, meet compliance requirements, or serve users closer to their location.
Important
An In-Place Migration runs bench migrate directly on your site and does not create a backup before execution. Ensure you have a recent backup available before proceeding.
Bench Selection During Migration
For most migration operations, you can choose where your site will be deployed after the migration.
- Select an Existing Bench
Move the site to a bench that already exists on the destination server. - Create a New Bench Automatically
Frappe Cloud clones your current bench configuration, including installed apps, and creates a new bench automatically before migrating your site.
Best Practice
Choose automatic bench creation when you want to preserve your existing bench configuration while keeping the migrated site isolated from other deployments.
What’s Next?
The following sections explain each migration type in detail, including when to use it, the migration workflow, and any prerequisites or considerations before starting the process.