Restore an Existing Site
You can restore an existing Frappe site on Frappe Cloud using backup files, the Bench CLI, the Frappe Cloud Restore CLI, or by migrating directly from another server. The recommended method depends on your backup size and deployment environment.
When restoring a site using backup files, don’t forget to restore the
Site Config as well. This ensures your encryption key and other configuration values are restored correctly.
Restore from Backup Files
The simplest way to migrate an existing site is by restoring a backup created using the
bench backup command.
- Create a backup using the
bench backupcommand. - Ensure the following files are available:
- Database Backup (.sql.gz)
- Public Files (.tar)
- Private Files (.tar)
- Site Config Backup (.json)
- Create a new site from the Frappe Cloud dashboard.
- Open the site’s Actions tab.
- Select Restore with Files.
- Upload each backup file into its corresponding field.
- Click Restore.
- Wait until the restore process finishes.
For backup files larger than 200 MB, use the Bench CLI or the Frappe Cloud Restore CLI instead of uploading through the dashboard.
Encryption Key
After restoring a site, copy the original encryption_key from your
site_config.json file into the new site’s configuration. Without it,
stored passwords cannot be decrypted.
If the original encryption key is unavailable, you’ll need to re-enter every password field (such as Email Accounts, API keys, and integrations) so they are encrypted using the new key.
