Help Center / Backups

Creating a Backup

Stack2X lets you back up your entire Supabase instance or just the parts you need. Backups run in the background, so you can keep working while Stack2X handles the rest.

Navigating to Backups

From your dashboard, click Backups in the sidebar. This opens the backups page where you can see your backup history and create new ones. If you haven't created a backup yet, you'll see a prompt to get started.

Selecting Your Instance

Click Create Backup to begin. The first step is choosing which connected Supabase instance you want to back up. If you only have one instance connected, it will be selected automatically. If you have multiple instances, pick the one you want from the dropdown.

Choosing What to Back Up

Stack2X supports both full and selective backups. A full backup captures everything -- your database schema, table data, auth users, storage buckets, edge functions, and project configuration.

If you don't need everything, you can select individual components:

  • Database -- Schema and table data
  • Auth -- Users, providers, and auth configuration
  • Storage -- Buckets and uploaded files
  • Edge Functions -- Function code and configuration
  • Project Config -- API settings, environment variables, and other project-level settings

Check or uncheck components based on what you need. Most users create full backups to ensure nothing is missed, but selective backups are useful when you only need to protect a specific part of your project.

Size Estimation

Before starting, Stack2X shows an estimated backup size based on the components you selected. This helps you understand how much storage the backup will use and whether it fits within your plan's storage limit. The estimate is approximate -- actual size may vary slightly.

Starting the Backup

Once you've made your selections, click Start Backup. Stack2X begins the process immediately. You'll see a progress indicator showing which component is currently being backed up and an estimated time remaining.

Monitoring Progress

You can leave the backups page and return at any time -- the backup continues running in the background. A small status badge appears in the sidebar to let you know it's still in progress. When the backup finishes, you'll see a notification confirming it completed successfully.

If anything goes wrong during the process, Stack2X displays an error message with details about what happened. You can retry the backup or adjust your selections and try again.

What's Next

Once your backup is complete, you can download it or restore it to another instance. Head over to Downloading and Restoring Backups to learn how.