Deployment & Branching

Deploying your app makes it live and accessible to users. Usually, you deploy an app to at least two environments: a production environment for users and (one or multiple) staging or preview environments for developers.

Supabase provides several options for environment management and deployment.

Environment management

You can maintain separate development, staging, and production environments for Supabase:

• Development: Develop with a local Supabase stack using the Supabase CLI.
• Staging: Use branching to create staging or preview environments. You can use persistent branches for a long-lived staging setup, or ephemeral branches for short-lived previews (which are often tied to a pull request).
• Production: If you have branching enabled, you can use the Supabase GitHub integration to automatically push your migration files when you merge a pull request. Alternatively, you can set up your own continuous deployment pipeline using the Supabase CLI.

<Admonition type="tip" title="Self-hosting">

Read the self-hosting guides for instructions on hosting your own Supabase stack.

</Admonition>

Deployment

You can automate deployments using:

• The Supabase GitHub integration (with branching enabled)
• The Supabase CLI in your own continuous deployment pipeline
• The Supabase Terraform provider