Supabase CLI: instálalo y aprende los comandos que vas a usar

Supabase CLI

Supabase CLI: instalación, entorno local y chuleta de comandos | We.Inc

Instala el Supabase CLI, ejecuta un entorno local, vincula un proyecto, sube migraciones, genera tipos y despliega Edge Functions, con una tabla de búsqueda de los comandos principales.

El Supabase CLI es un programa de línea de comandos que ejecuta una copia de Supabase en tu propio ordenador y lleva los cambios de la base de datos a tu proyecto en producción. Instálalo con Homebrew, Scoop o npm, ejecuta supabase init y supabase start, y después supabase link y supabase db push para enviar las migraciones al proyecto alojado.

Formas de instalar el Supabase CLI

Escribe parte de un comando o una palabra como types, o elige un grupo, para filtrar la tabla de abajo. Cada fila es un comando de la referencia oficial del CLI con una nota breve sobre cuándo lo necesita el dueño de un sitio.

Preguntas frecuentes

¿Necesito Docker para el Supabase CLI?

Para el entorno local, sí, u otro entorno de contenedores. La guía menciona OrbStack, Rancher Desktop, Podman y colima como alternativas, y un entorno nativo experimental para Linux y Mac con Apple silicon.

¿Puedo instalar el Supabase CLI de forma global con npm?

La guía oficial indica que el paquete de npm añade el CLI a un único proyecto y no como comando global. Usa Homebrew o Scoop para una instalación en todo el sistema.

¿Qué diferencia hay entre db push y db pull?

db push envía tus archivos de migración locales a una base de datos. db pull lee el esquema de una base de datos remota y lo escribe en un nuevo archivo de migración, algo útil cuando se han hecho cambios desde el panel.

¿Cómo genero los tipos de TypeScript?

Ejecuta supabase gen types --lang typescript con --local para la base de datos local o --linked para la alojada, y redirige la salida a un archivo de tu proyecto.

¿Cómo despliego una Edge Function?

Crea una con supabase functions new y un nombre, y después ejecuta supabase functions deploy con ese nombre. Define sus secretos con supabase secrets set NAME=VALUE.

Por qué usar migraciones en lugar de hacer clic en el panel

Una primera sesión de principio a fin

Ejecuta esto en la carpeta de tu proyecto. Sustituye el ID de referencia por el que aparece en los ajustes de tu proyecto.

Del entorno local al proyecto alojado

El orden importa: crea la migración, compruébala en local con un reset y después súbela.

Buscador de comandos

Buscar comandos

push, types, functions...

Grupo

Todos

Configuración

Entorno local

Base de datos

Tipos

Edge Functions

Comando

Qué hace

{n} comandos mostrados

Ningún comando coincide. Borra la búsqueda para verlos todos.

Inicia sesión del CLI en tu cuenta de Supabase desde el navegador, o con --token.

Crea la carpeta supabase y el archivo de configuración en el proyecto actual.

Arranca el entorno local en contenedores y muestra las URLs y claves locales.

Detiene el entorno local. Añade --no-backup para descartar los datos locales.

Vuelve a mostrar las URLs y claves locales. Añade -o env para mostrarlas como variables de entorno.

Crea un archivo SQL vacío con marca de tiempo en supabase/migrations para tu cambio.

Reconstruye la base de datos local a partir de las migraciones y ejecuta el archivo seed.

Aplica las nuevas migraciones locales a la base de datos vinculada. Prueba antes --dry-run.

Escribe el esquema remoto en un nuevo archivo de migración. Necesita un daemon de Docker en marcha.

Compara esquemas y guarda la diferencia como migración con -f.

Escribe los tipos de TypeScript de tus tablas. Usa --local para la base de datos local.

Crea una carpeta nueva de Edge Function con código inicial.

Ejecuta tus Edge Functions en local mientras pruebas.

Sube una Edge Function al proyecto alojado.

Guarda un secreto, como una clave de pagos, para tus Edge Functions alojadas.

Empieza gratis · Sin tarjeta de crédito

Relacionado: Guías

Producto

Para quién es

Funciones

Recursos

Empresa

Mapa del sitio