mirror of
https://github.com/supabase/supabase.git
synced 2026-10-11 12:25:05 +03:00
59 lines
3.7 KiB
Plaintext
59 lines
3.7 KiB
Plaintext
---
|
||
title: Restore to a new project
|
||
subtitle: How to clone your existing Supabase project
|
||
---
|
||
|
||
|
||
<Admonition type="note" label="Beta Version">
|
||
|
||
This process creates a database-only copy and requires manual reconfiguration to fully replicate your original project.
|
||
|
||
</Admonition>
|
||
|
||
Whether you're using physical backups or [Point-in-Time recovery (PITR)](/docs/guides/platform/backups#point-in-time-recovery), this feature allows you to duplicate project data with ease, perform testing safely, or recover data for analysis.
|
||
|
||
Restoring to a new project is an excellent way to manage environments more effectively. You can use this feature to create staging environments for testing, experiment with changes without risk to production data, or swiftly recover from unexpected data loss scenarios.
|
||
|
||
## Things to keep in mind
|
||
|
||
The feature is only accessible to paid plan users with physical backups enabled.
|
||
|
||
<Admonition type="note" label="Cross region cloning is not supported">
|
||
The newly cloned project and its data will remain in the same region as the source project to ensure compliance with data residency requirements.
|
||
</Admonition>
|
||
|
||
|
||
<$Partial path="restore_transferred.mdx" variables={{ "extras": "- Configurations: compute instance size, disk attributes, SSL enforcement settings, and network restrictions" }} />
|
||
|
||
<$Partial path="restore_manual_configuration.mdx" variables={{ "extras": "" }} />
|
||
|
||
## Restore to a new project
|
||
|
||
To begin, switch to the source project—the project containing the data you wish to restore—and go to the [database backups](/dashboard/project/_/database/backups/restore-to-new-project) page. Select the **Restore to a New Project** tab.
|
||
|
||
A list of available backups is displayed. Select the backup you want to use and click the "Restore" button. For projects with PITR enabled, use the date and time selector to specify the exact point in time from which you wish to restore data.
|
||
|
||
You’ll be presented with an overview of the costs associated with creating the new project. The new project will incur additional monthly expenses based on the mirrored resources from the source project. It’s important to review these costs carefully before proceeding.
|
||
|
||
<Admonition type="note">
|
||
|
||
The time required to complete the restoration can vary depending largely on the volume of data involved. If you have a large amount of data you can opt for higher performing disk attributes on the source project _before_ starting a clone operation. These disk attributes will be replicated to the new project. This incurs additional costs which will be displayed before starting.
|
||
|
||
</Admonition>
|
||
|
||
Once the restoration is complete, the new project will be available in your dashboard and will include all data, tables, schemas, and selected settings from the chosen backup source. It is recommended to thoroughly review the new project and perform any necessary tests to ensure everything has been restored as expected.
|
||
|
||
### Restore other settings / configurations
|
||
- [Migrate Edge Functions](/docs/guides/platform/migrating-within-supabase/migrate-edge-functions)
|
||
- [Migrate Storage](/docs/guides/platform/migrating-within-supabase/migrate-storage)
|
||
- [Migrate Project Configurations](/docs/guides/platform/migrating-within-supabase/migrate-project-configurations)
|
||
|
||
New projects are completely independent of their source, and as such can be modified and used as desired.
|
||
|
||
<Admonition type="note">
|
||
|
||
As the entire database is copied to the new project, this will include all extensions that were enabled at the source. If the source project included extensions that are configured to carry out external operations—for example pg_net, pg_cron, wrappers—these should be disabled once the copy process has completed to avoid any unwanted actions from taking place.
|
||
|
||
</Admonition>
|
||
|