← Volver a docs
⚡Supabase CLI·cli

Supabase CLI — Guía de inicio

Instala, inicializa y sincroniza tu base de datos local con Supabase CLI.

Última actualización: 11 de julio de 2026

Instalación

# macOS (con Homebrew)
brew install supabase/tap/supabase

# Windows (con Scoop)
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git
scoop install supabase

# Linux
brew install supabase/tap/supabase

# O como binario standalone
# descarga desde https://github.com/supabase/cli/releases

Verifica:

supabase --version

Inicializar proyecto local

Dentro de tu proyecto:

supabase init

Esto crea la carpeta supabase/ con:

supabase/
├── migrations/         ← SQL versionado
├── functions/          ← Edge Functions (Deno)
├── config.toml         ← configuración
└── seed.sql            ← datos iniciales (opcional)

Stack local completo

Levanta Postgres + Studio + Auth + Storage en Docker:

supabase start

Tarda 1-2 minutos la primera vez. Te dará:

API URL:    http://127.0.0.1:54321
DB URL:     postgresql://postgres:postgres@127.0.0.1:54322/postgres
Studio URL: http://127.0.0.1:54323
anon key:   eyJh...
service_role key: eyJh...

Para parar:

supabase stop

Vincular a proyecto remoto

supabase login                                          # abre navegador
supabase link --project-ref abcdefghijkl               # tu project-ref
# te pide la password de la DB

Workflow de migraciones

# Crear migración vacía
supabase migration new create_posts_table

# Editar supabase/migrations/<timestamp>_create_posts_table.sql

# Aplicar a la DB remota
supabase db push

# Aplicar a la DB local
supabase db reset        # ⚠️ borra datos locales

Edge Functions

# Crear función nueva
supabase functions new hello

# Editar supabase/functions/hello/index.ts

# Servir localmente
supabase functions serve hello

# Deploy a producción
supabase functions deploy hello

# Con secretos
supabase secrets set OPENAI_API_KEY=sk-xxx

Generar tipos TypeScript

supabase gen types typescript --linked > src/lib/database.types.ts

Ahora tu código tiene autocompletado y type-safety completo.

Comandos útiles

supabase status          # estado del stack local
supabase db diff         # diferencias entre local y remoto
supabase db lint         # validar SQL
supabase db reset        # resetear DB local
supabase secrets list    # ver secretos
supabase functions list  # listar funciones deployadas

Recursos