Supabase Postgres de código abierto: instalar y supervisar

Supabase Postgres de código abierto: instalación con Docker según la documentación, arquitectura, supervisión en autoalojamiento y límites de la pila.
Supabase Postgres open source : installer et superviser

Supabase Postgres de código abierto: el repositorio supabase/supabase reúne una plataforma de desarrollo construida en torno a PostgreSQL, con autenticación, APIs automáticas, almacenamiento de archivos, funciones y una caja de herramientas para vectores e IA. Mostraba unas 113 200 estrellas en octubre de 2026, con licencia Apache-2.0. El README la presenta como «la plataforma de desarrollo de Postgres» que construye las funciones de Firebase con herramientas de código abierto de nivel empresarial.

Para un equipo de producto, es un back-end listo para usar. Para un equipo de operaciones, es sobre todo una pila de varios servicios que hay que alojar y vigilar si se elige el autoalojamiento. Este artículo presenta lo que dice el repositorio, la instalación con Docker según la documentación y lo que se puede observar, con un límite importante: la API de métricas del servicio alojado no existe en el autoalojamiento.

La información procede del README y de la documentación oficial. span.observer no ha instalado Supabase: las imágenes siguientes proceden del repositorio y de la documentación del proyecto.

Supabase Postgres de código abierto: lo que dice el repositorio

  • Licencia: Apache-2.0 (archivo LICENSE del repositorio). El README añade que el proyecto usa herramientas con licencia MIT, Apache 2 o equivalente cuando existen, y que desarrolla y abre él mismo las demás: es la descripción del proyecto.
  • Funciones listadas: base de datos Postgres alojada, autenticación y autorización, APIs generadas (REST, GraphQL, suscripciones en tiempo real), funciones de base de datos y Edge Functions, almacenamiento de archivos, caja de herramientas de IA y vectores, dashboard.
  • Modos de uso: plataforma alojada (sin instalación), autoalojamiento o desarrollo local, según el README.
  • Clientes oficiales: JavaScript y TypeScript, Flutter, Swift y Python; otros lenguajes los mantiene la comunidad.
  • Versiones: el repositorio no publica ninguna versión en su página de releases en la fecha de lectura; la documentación de autoalojamiento cita una etiqueta self-hosted/v0.8.3.
Captura del README de Supabase: dashboard de una función Edge con las curvas de tiempo de ejecución, el número de invocaciones y el número de errores durante siete días
Source : github.com

La captura del README muestra el dashboard (Studio) sobre una Edge Function: tiempo de ejecución, invocaciones y errores. Es la vista básica de «salud» del lado de la aplicación.

Esquema de arquitectura del repositorio de Supabase: una pasarela Envoy que enruta /auth hacia GoTrue, /rest hacia PostgREST, /realtime hacia Realtime, /storage hacia Storage, /pg hacia pg-meta, /functions hacia Functions y /graphql hacia pg_graphql, todos conectados a PostgreSQL
Source : github.com

El esquema de arquitectura muestra lo esencial: una pasarela Envoy enruta cada ruta hacia un servicio, y todos se apoyan en PostgreSQL. El README describe estos componentes: Postgres, Realtime (servidor Elixir que difunde los cambios de la base mediante websockets), PostgREST (API REST generada), GoTrue (autenticación mediante JWT), Storage (archivos en S3, permisos en Postgres), pg_graphql y postgres-meta.

Instalar Supabase en autoalojamiento con Docker

Paso 1 — Requisitos previos

La documentación supone que te manejas con la administración de Linux, Git, Docker y Docker Compose. Recursos mínimos: 4 GB de RAM, 2 núcleos, 40 GB de SSD; recomendados: 8 GB o más, 4 núcleos o más, 80 GB o más.

Paso 2 — Inicio rápido en Linux

curl -fsSL https://supabase.link/setup.sh | sh
cd supabase-project && \
sh run.sh start

El script, compatible con Debian, Ubuntu y la familia RHEL, instala los requisitos previos, recupera la configuración, genera los secretos y las claves y prepara las imágenes. La documentación precisa que el enlace acortado apunta a setup.sh: inspecciónalo antes de ejecutarlo. sh run.sh secrets muestra las credenciales generadas.

Paso 3 — O instalación manual, en cualquier sistema

Comandos de la documentación de autoalojamiento de Supabase: clonado del repositorio en la etiqueta self-hosted/v0.8.3, copia de la configuración de Docker, creación del archivo .env, docker compose pull y después scripts de generación de claves
Source : supabase.com

El archivo .env.example contiene contraseñas de ejemplo. La documentación advierte de que nunca se arranque con esos valores: genera los secretos con sh utils/generate-keys.sh y sh utils/add-new-auth-keys.sh, y ajusta después SUPABASE_PUBLIC_URL, API_EXTERNAL_URL y SITE_URL. La pasarela escucha por defecto en el puerto 8000.

Supervisar Supabase

Lo que ofrece el servicio alojado

La documentación describe una API de métricas compatible con Prometheus (unas 200 series de Postgres) para conectar a Grafana u otras herramientas. Precisa que esta API está en beta, que los nombres de las métricas pueden cambiar y que no está disponible en las instancias autoalojadas.

En autoalojamiento

La configuración por defecto no incluye Logs ni Analytics. La documentación indica que se pueden activar Logflare (analítica), Vector (recogida de logs) y el Log Explorer de Studio con un archivo de override de Docker Compose, a costa de recursos adicionales. Para lo demás, supervisas una pila Docker clásica:

  • Contenedores y recursos: estado, reinicios y memoria de cada servicio (pasarela, base de datos, autenticación, Realtime, Storage…), con tus herramientas habituales.
  • PostgreSQL: conexiones, bloqueos, consultas lentas y replicación, con un exportador adecuado; para el transporte de las señales, consulta el Collector de OpenTelemetry hacia Dynatrace.
  • Logs: si los envías a una plataforma, conserva el identificador de traza en cada línea; consulta los logs de OpenTelemetry con trace ID.

No he encontrado ninguna exportación nativa de OpenTelemetry documentada para la pila autoalojada.

Cómo comprobar que funciona

  • docker compose ps muestra todos los servicios iniciados y en buen estado.
  • El dashboard de Studio se abre en la dirección de la pasarela, con la contraseña generada durante la instalación.
  • Una petición a la API REST de una tabla de prueba responde, y el registro del contenedor correspondiente la muestra.

Límites y puntos abiertos

  • Tú operas la pila: copias de seguridad, actualizaciones, TLS y seguridad de red corren por tu cuenta; la documentación recomienda la plataforma alojada si estos temas te resultan nuevos.
  • Paridad parcial: la API de métricas no existe en el autoalojamiento; comprueba la lista de funciones antes de migrar.
  • Secretos por defecto: no conserves nunca los valores de .env.example.
  • Versión de referencia: sin página de releases, la etiqueta self-hosted/… de la documentación sirve de referencia; anótala en cada instalación.

Buenas prácticas

  • Fija la etiqueta de configuración (self-hosted/vX.Y.Z) y relee las notas antes de actualizar.
  • No publiques la base de datos en Internet: pasa por la pasarela y un proxy TLS.
  • Relee la documentación de control de acceso a los datos antes de exponer tablas mediante la API.
  • Planifica copias de seguridad de la base de datos y prueba la restauración.
  • Para un stack de IA completo, consulta el stack de IA de código abierto autoalojado y Dify y n8n.

Preguntas frecuentes

¿Es Supabase realmente un sustituto de Firebase?

El proyecto se describe como constructor de las funciones de Firebase con herramientas de código abierto, pero precisa que no es una correspondencia uno a uno: la base de datos es PostgreSQL, no un almacén de documentos.

¿Se puede usar para vectores y para IA?

El README lista una caja de herramientas de IA y vectores. Consulta su documentación para conocer las extensiones y los límites de tu versión.

¿Es gratuito el autoalojamiento?

El código tiene licencia Apache-2.0; el servidor, el almacenamiento y la operación corren por tu cuenta.

Conclusión

Supabase reúne componentes de código abierto en torno a PostgreSQL y ofrece dos caminos: el servicio alojado, o una pila Docker que operar tú mismo. En el segundo caso, prevé desde el principio la supervisión de los contenedores y de la base de datos, porque la API de métricas del servicio alojado no está incluida.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial (supabase.com/docs).

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Graphify graphe de connaissances : cartographier un code

Graphify grafo de conocimiento: cartografiar un código

Next Post
Twenty CRM open source : installer, licence et supervision

Twenty CRM código abierto: instalar, licencia y monitorización

Related Posts