Link Project

Connect your local project to your remote Supabase project to enable deployments and migrations.

Find Your Project Reference

You'll need your project's reference ID. Find it in the Supabase dashboard:

The project reference is also in your project's URL:https://supabase.com/dashboard/project/[reference-id]

Run the link command with your project reference:

supabase link --project-ref YOUR_PROJECT_REF

You'll be prompted for your database password. This is the password you set when creating the Supabase project.

You can reset the database password in Settings → Database → Database Password. Note: This will require updating any existing connections.

After linking, verify the connection:

supabase db remote commit

This command syncs your local migrations with the remote database state. It should complete without errors if the link is successful.

Push and pull database schema changes between local and remote.

Deploy Deno functions to your Supabase project.

Manage storage buckets and policies.

Sync authentication providers and settings.