VPS: Configura Supabase en Windows

Esta guía fue creada con los siguientes productos:

(Los detalles pueden variar según los productos de diferentes proveedores, pero los conceptos principales permanecen igual)

VPS

Introducción

Supabase es una plataforma de desarrollo Postgres open-source que ofrece una base de datos Postgres completa más autenticación, APIs instantáneas, tiempo real y almacenamiento, convirtiéndola en una alternativa open-source a Firebase.

¿Estás pensando en alojar este servicio por tu cuenta? Te guiaremos paso a paso para configurarlo y ajustarlo, junto con todo lo que debes tener en cuenta.

Requisitos previos

Antes de instalar Supabase, asegúrate de que tu entorno de hosting cumple con los siguientes requisitos para garantizar una instalación sin problemas y un rendimiento óptimo.

Hardware	Mínimo	Recomendación ZAP-Hosting
CPU	1 núcleo vCPU	4 núcleos vCPU
RAM	4 GB	8 GB
Espacio en disco	25 GB	25 GB

El software requiere que todas las dependencias necesarias estén instaladas y que se ejecute en un sistema operativo compatible. Asegúrate de que tu servidor cumple con los siguientes requisitos antes de continuar con la instalación:

Dependencias: Git, Docker (Engine y Compose)

Sistema operativo: Última versión de Ubuntu/Debian que soporte Docker 2

Verifica que todas las dependencias estén instaladas y que la versión del sistema operativo sea la correcta para evitar problemas de compatibilidad durante la instalación de Supabase.

Preparación

Antes de configurar Supabase, necesitas preparar tu sistema. Esto incluye actualizar tu sistema operativo a la última versión e instalar todas las dependencias necesarias. Estas preparaciones aseguran un entorno estable y ayudan a prevenir problemas durante o después de la instalación.

Actualizar sistema

Para asegurarte de que tu sistema está corriendo con el software y parches de seguridad más recientes, siempre debes realizar primero las actualizaciones del sistema. Esto garantiza que tu sistema tenga las últimas mejoras antes de continuar.

Instalar dependencias

Una vez completado el proceso de actualización, puedes proceder con la instalación de las dependencias.

Git

Los datos de Supabase se descargarán a través de GitHub. Por eso, primero necesitas tener Git instalado. Para ello, instala Git para Windows en tu servidor.

Docker

Supabase se desplegará y ejecutará en tu máquina usando un contenedor Docker. Por eso, primero necesitas instalar Docker. Para ello, instala Docker Desktop en tu servidor.

Un tutorial completo del proceso de instalación y cómo usar Docker está disponible en nuestra guía Docker.

Instalación

Ahora que todos los requisitos están cumplidos y las preparaciones hechas, puedes proceder con la instalación de la aplicación Supabase. Abre la consola de comandos. Clona el repositorio de Supabase, crea un directorio dedicado para el proyecto y copia los archivos Docker y el archivo de entorno de ejemplo dentro.

git clone --depth 1 https://github.com/supabase/supabase
mkdir .\supabase-project

Copy-Item .\supabase\docker\* -Destination .\supabase-project -Recurse -Force
Copy-Item .\supabase\docker\.env.example -Destination .\supabase-project\.env -Force

Cambia al directorio del proyecto, descarga las imágenes más recientes del contenedor y lanza el stack en modo detached.

cd supabase-project
docker compose pull
docker compose up -d

Ahora puedes acceder a Supabase Studio a través de http://<tu-ip>:8000. Se te pedirá un usuario y contraseña. Por defecto, las credenciales son:

• Usuario: supabase
• Contraseña: this_password_is_insecure_and_should_be_updated

Credenciales por defecto

Tu app está corriendo con credenciales por defecto. Asegura tus servicios lo antes posible usando las instrucciones a continuación.

Configuración

Nunca deberías desplegar con valores por defecto o de ejemplo. Debes reemplazar todos los placeholders por secretos fuertes y únicos, revisar la configuración según tus requisitos de seguridad y reiniciar todos los servicios para aplicar los cambios.

Genera claves API seguras antes de exponer cualquier servicio. Empieza eligiendo un secreto JWT de 40 caracteres. Puedes usar el valor proporcionado o crear uno propio. Guarda este secreto localmente en un lugar seguro. No lo compartas ni lo subas a control de versiones. Usa el secreto para generar un JWT y luego deriva las claves API anon y service usando el formulario referenciado en la documentación de Supabase: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys

Ejecuta el formulario dos veces para obtener ambas claves. Actualiza tu ./docker/.env con:

• ANON_KEY: clave anon
• SERVICE_ROLE_KEY: clave service

Actualiza los secretos requeridos en ./docker/.env. Estos valores deben estar configurados para un despliegue funcional:

• POSTGRES_PASSWORD: contraseña para el rol postgres
• JWT_SECRET: consumido por PostgREST y GoTrue
• SITE_URL: URL base de tu sitio
• SMTP_*: credenciales del servidor de correo
• POOLER_TENANT_ID: ID de tenant usado por el pooler Supavisor

Protege el panel con nuevas credenciales antes de usar en producción. Edita ./docker/.env:

• DASHBOARD_USERNAME: usuario del panel
• DASHBOARD_PASSWORD: contraseña del panel

Puedes definir múltiples usuarios para el panel en ./docker/volumes/api/kong.yml:

basicauth_credentials:
  - consumer: DASHBOARD
    username: user_one
    password: password_one
  - consumer: DASHBOARD
    username: user_two
    password: password_two

Para habilitar todas las funciones del panel fuera de localhost, configura SUPABASE_PUBLIC_URL en ./docker/.env con la URL o IP que usarás para acceder al panel.

Aplica los cambios reiniciando el stack:

docker compose down
docker compose up -d

Conclusión y más recursos

¡Felicidades! Ya instalaste y configuraste Supabase en tu VPS con éxito. También te recomendamos echar un vistazo a estos recursos, que pueden darte ayuda y guía extra durante la configuración de tu servidor:

• Supabase.com - Sitio oficial
• Supabase.com/docs/guides/self-hosting - Documentación de Supabase

¿Tienes preguntas específicas que no se cubren aquí? Para dudas o asistencia, no dudes en contactar a nuestro equipo de soporte, ¡disponible todos los días para ayudarte! 🙂