# Hostear Supabase: Postgres, Auth, Storage y lo que operás

Hostear Supabase es un stack de Docker, no un contenedor. Operás Postgres, Auth, Storage, secretos, backups y la URL pública.

Canonical URL: https://unbroker.cloud/es/blog/self-host-supabase
Published: 2026-11-06
Reviewed: 2026-11-06
Author: Timoteo Borgobello

## La respuesta corta

Hostear Supabase es correr un stack de Docker Compose, no un contenedor. Operás los secretos, los backups, las actualizaciones y las URLs públicas. Los datos de Postgres y los archivos de Storage tienen que sobrevivir a un contenedor nuevo.

En Unbroker no hay una plantilla de Supabase, y esta nota no promete una. Las plantillas que existen están en el [índice de plantillas](https://unbroker.cloud/templates). Una app self-hosted más chica, con su propio Postgres, es [self-host de n8n](https://unbroker.cloud/es/blog/self-host-n8n). El mapa de un archivo Compose a servicios está en [Docker Compose en producción](https://unbroker.cloud/es/blog/docker-compose-to-production).

## Qué significa hostearlo

La guía de Docker de Supabase es la fuente del stack. La lista de arquitectura es Studio, Envoy, Auth, PostgREST, Realtime, Storage, imgproxy, postgres-meta, Postgres, Edge Runtime y Supavisor. Logflare y Vector no están en la configuración por defecto. Prenderlos sube el consumo.

Envoy es el API gateway por defecto. Kong es un override opcional, no el gateway que usa el setup inicial. El gateway escucha en el puerto 8000. REST, Auth, Storage y Realtime son rutas de ese mismo gateway.

La instalación manual de la guía clona un tag `self-hosted/v*`. El ejemplo de la página es `self-hosted/v0.8.4`. Volvé a leer la guía para el tag vigente. Las imágenes de un snapshot se prueban juntas. Cambiar el tag de una sola imagen está permitido, y la compatibilidad no está garantizada. La fuente es [self-hosting with Docker](https://supabase.com/docs/guides/self-hosting/docker).

Podés sacar servicios que no uses, entre ellos Realtime, Storage, imgproxy y Edge Runtime (`functions`), y borrar sus dependencias del Compose. Eso puede bajar el consumo. También saca esas APIs.

## Lo que operás

El `.env` de ejemplo no es una configuración para arrancar. Supabase dice que no hay que iniciar el stack con esos valores por defecto. `generate-keys.sh` escribe contraseñas y secretos. `add-new-auth-keys.sh` agrega las API keys y el par de claves asimétricas para firmar JWT. Los valores que le pasás a una aplicación son `POSTGRES_PASSWORD`, `SUPABASE_PUBLISHABLE_KEY`, `SUPABASE_SECRET_KEY` y `SUPABASE_PUBLIC_URL`. La secret key se queda en el servidor.

Tres URLs tienen que coincidir con la forma en que los clientes llegan al stack:

```text
SUPABASE_PUBLIC_URL=http://example.com:8000
API_EXTERNAL_URL=http://example.com:8000/auth/v1
SITE_URL=http://example.com:3000
```

`SUPABASE_PUBLIC_URL` es la URL base del dashboard, de la API y de Storage. `API_EXTERNAL_URL` es la que usa Auth para los callbacks. `SITE_URL` es el redirect por defecto de Auth. El inicio rápido de Linux también pide `PROXY_DOMAIN`. Detrás de un proxy TLS, la URL pública es `https://` en el puerto 443, no `:8000`.

Studio usa HTTP basic auth. Definí `DASHBOARD_PASSWORD` antes del primer arranque. La contraseña tiene que incluir al menos una letra. Solo números no sirve, y los caracteres especiales tampoco. `DASHBOARD_USERNAME` es opcional.

El Postgres de un Supabase self-hosted es la base que comparten esos servicios. Supabase Storage, cuando lo hosteás, guarda los archivos en el disco del servidor por defecto, con un bind mount. Un backend compatible con S3 es otra configuración, no el valor por defecto.

## Postgres: nodo de Apps o Postgres gestionado

Unbroker tiene dos modelos de base. Un nodo de base en Apps es un servicio privado a partir de una imagen de base de datos. Operás más del motor: actualizaciones, usuarios y la recuperación de su volumen. Una base gestionada es un clúster que opera el proveedor. La comparación está en [elegir un modelo de base](https://docs.unbroker.cloud/databases/choose).

El contenedor de Postgres del Compose de Supabase es el primer modelo. Los scripts de migración de schema se montan en `/docker-entrypoint-initdb.d` y corren cuando ese contenedor arranca. Auth, Storage, Realtime y PostgREST esperan esa base, sus roles y sus extensiones. El Postgres gestionado no reemplaza ese contenedor. Es un clúster que das de alta para datos de una aplicación, con su plan y sus datos de conexión.

El Postgres gestionado requiere Pro. El plan más chico del catálogo es 1 vCPU, 1 GB de RAM y 10 GB de almacenamiento, hasta 30 GB en ese plan, a $21.21 por mes. El almacenamiento extra de un plan sale $0.30 por GB al mes. Pro sale $25 por mes con $25 de crédito de uso, y el precio del clúster va aparte. Free no incluye bases gestionadas. El plan de 1 GB es un solo nodo. Los nodos de standby piden un plan de al menos 2 GB de RAM. Leé el precio cotizado en el alta. La lista está en [Postgres gestionado](https://unbroker.cloud/managed-databases/postgres). Operar la base que te quedás está en [Postgres en producción](https://unbroker.cloud/es/blog/postgres-in-production).

## Volúmenes para Postgres y Storage

El script de desinstalación borra el directorio de datos de Postgres `volumes/db/data` y los datos de Storage en `volumes/storage`. Esos son los dos almacenes que tienen que sobrevivir a un contenedor.

En Unbroker un volumen pertenece a un servicio y se monta en una ruta absoluta. Puede crecer, hasta 50 GB, y no puede achicarse. Crecer no reinicia el servicio. Borrar el servicio borra el volumen y sus datos. Un servicio con volumen corre una sola réplica. Los archivos fuera del volumen son temporales, porque un deploy, un reinicio o una reprogramación pueden reemplazar el contenedor.

Un volumen no es un backup. Cloud Apps puede mandar backups del volumen a un destino compatible con S3 que controlás. Restaurar es otra acción, y la confirmás con el nombre del servicio. Las reglas están en [almacenamiento persistente](https://docs.unbroker.cloud/apps/storage) y en [almacenamiento persistente y volúmenes](https://unbroker.cloud/es/blog/persistent-storage-volumes).

## El gateway, Studio y las URLs públicas

Publicá el gateway. Dejá el resto en privado. Studio se abre por el gateway en el puerto 8000, y las APIs son rutas de ese mismo puerto: `/rest/v1/`, `/auth/v1/`, `/storage/v1/` y `/realtime/v1/`. Un servicio privado no tiene URL pública. Otro servicio del mismo entorno usa el host y el puerto de ese servicio. Un preview no llega a producción.

La guía de Supabase pone un proxy reverso delante del gateway cuando hace falta HTTPS. En Unbroker, un dominio propio y el TLS gestionado requieren Pro. El hostname por defecto sigue. Los pasos están en [dominio propio y HTTPS](https://unbroker.cloud/es/blog/custom-domain-https). Poné la URL que usan los clientes en `SUPABASE_PUBLIC_URL`, `API_EXTERNAL_URL` y `SITE_URL`. No publiques los secretos de ejemplo en ese mismo archivo.

## Recursos mínimos

La guía de Docker de Supabase da un mínimo para correr todos los componentes, para desarrollo y para producción chica o mediana:

| Recurso | Mínimo | Recomendado |
| --- | --- | --- |
| RAM | 4 GB | 8 GB o más |
| CPU | 2 núcleos | 4 núcleos o más |
| Disco | SSD de 40 GB | SSD de 80 GB o más |

Esas cifras son de Supabase, para esa instalación Compose en una máquina. No son un tamaño de servidor de Unbroker. Sacar servicios que no corrés puede bajar lo que el stack pide. Prender Logs y Analytics suma Logflare y Vector y sube el consumo.

## Correrlo en Unbroker

Mapeá el Compose como [Docker Compose en producción](https://unbroker.cloud/es/blog/docker-compose-to-production) mapea cualquier archivo: un servicio por pieza, secretos en variables de entorno y solo el gateway público. Un servicio de imagen baja un tag o un digest fijado y corre una réplica. Preferí el tag del snapshot que probaste. El recorrido de Docker está en [desplegar un contenedor](https://docs.unbroker.cloud/guides/deploy-docker).

Pegar un archivo Compose crea un servicio por entrada para imágenes, entorno, puertos, comandos y un volumen por servicio. No decide qué es público, y no convierte el Postgres de Supabase en un clúster gestionado. Revisá cada servicio después de pegarlo.

Free no puede correr este stack. Las imágenes, los builds con Dockerfile, los volúmenes persistentes y las bases gestionadas son Pro. Los dominios propios son Pro. Los servicios Free corren en el runtime serverless, que no incluye imágenes, Dockerfiles, volúmenes ni redes privadas. Pro sale $25 por mes con $25 de crédito de uso. El crédito no se acumula. Si el uso queda por debajo del crédito, el cargo sigue siendo $25. Las cifras actuales están en [precios](https://unbroker.cloud/es/precios). Las filas del plan están en [Plans](https://docs.unbroker.cloud/billing/plans).

Si el Compose tiene que quedarse en una máquina que operás vos, ese host es un [servidor Linux en la nube](https://unbroker.cloud/es/servidores-cloud). Esta nota no elige un tamaño. Los mínimos de Supabase de arriba son los requisitos de su guía, no una fila del catálogo.

## Backups, actualizaciones y rotación de secretos

`reset.sh` frena el stack, saca los volúmenes de Docker y borra los datos de Postgres y los archivos de Storage. Eso es una desinstalación, no un backup.

Hacé backup del volumen de Postgres y del volumen de Storage, y restaurá uno de cada uno antes de depender de ellos. Rotar una clave sin una copia de los datos no devuelve los archivos. Si la app se generó en otro lado y la base sigue en Supabase hospedado, las reglas de acceso se quedan en ese proyecto. Ese corte está en [una app hecha con IA en producción](https://unbroker.cloud/es/blog/ai-built-app-to-production).

Las actualizaciones siguen el `update.sh` de Supabase, que mezcla un snapshot `self-hosted/v*` más nuevo sobre los archivos que tenés. Para mover un solo servicio, cambiá su tag de imagen, hacé pull y recreá ese servicio. El ejemplo de Studio de la guía es un tag con forma `2026.04.27-sha-5f60601`. Fijá el tag que querés correr. Un tag más nuevo en Docker Hub no es automáticamente el snapshot con el que se probó el resto del stack.

Las API keys viven en `.env`, no en una rotación del dashboard. `rotate-new-api-keys.sh --update-env` rota `SUPABASE_PUBLISHABLE_KEY` y `SUPABASE_SECRET_KEY` sin cambiar el par de claves asimétricas, y después recreás los servicios y actualizás las aplicaciones. Esa rotación no invalida los tokens de sesión que ya existen. Regenerar el par asimétrico sí afecta las sesiones activas. `db-passwd.sh` cambia la contraseña de la base y reescribe `.env`. Después, recreá el stack.

## Lista de control

1. Arrancá desde el tag `self-hosted/v*` vigente de la guía de Docker, no desde los secretos de ejemplo.
2. Corré los scripts de claves antes del primer arranque. Definí una contraseña de Studio con una letra y sin caracteres especiales.
3. Configurá `SUPABASE_PUBLIC_URL`, `API_EXTERNAL_URL` y `SITE_URL` con las URLs que usan los clientes.
4. Dejá los datos de Postgres y los archivos de Storage en volúmenes. Hacé backup a un almacenamiento que controles, y restaurá una vez.
5. Publicá el gateway. Dejá los otros servicios en privado.
6. Fijá cada imagen al tag o al digest que probaste con el resto del stack.
7. Usá Pro. Las imágenes, los Dockerfiles, los volúmenes, los dominios propios y las bases gestionadas no están en Free.
8. No apuntes el stack a Postgres gestionado esperando los roles y los scripts de inicio de la base del Compose.

## Preguntas frecuentes

### ¿Qué hace falta para hostear Supabase?

El stack oficial de Docker Compose, secretos generados y no el .env de ejemplo, URLs públicas para Auth y la API, y almacenamiento durable para Postgres y para los archivos de Storage. En Unbroker eso pide Pro, porque las imágenes, los Dockerfiles y los volúmenes persistentes no están en Free.

### ¿Supabase self-hosted es un solo contenedor?

No. La guía de Docker de Supabase describe un stack: Studio, el API gateway, Auth, PostgREST, Realtime, Storage, imgproxy, postgres-meta, Postgres, Edge Runtime y Supavisor. Logflare y Vector son opcionales y vienen apagados.

### ¿Qué servicios trae el stack de Docker?

La lista de arquitectura es Studio, Envoy como gateway por defecto, Auth, PostgREST, Realtime, Storage, imgproxy, postgres-meta, Postgres, Edge Runtime y Supavisor. Kong es un override opcional del gateway, no el valor por defecto. Podés sacar servicios que no uses, como Realtime, Storage, imgproxy o Edge Runtime.

### ¿Hay una plantilla de Supabase de un clic en Unbroker?

No. No hay una plantilla de Supabase. Las plantillas que existen están en el índice de plantillas. La plantilla de n8n es otro producto. No busques un botón de deploy de Supabase.

### ¿Se puede hostear Supabase en el plan Free?

No. Free no incluye imágenes de contenedor, builds con Dockerfile, volúmenes persistentes, dominios propios ni bases gestionadas. Los servicios Free usan el runtime serverless, que no incluye redes privadas. Pro sale $25 por mes con $25 de crédito de uso.

### ¿El Postgres de Supabase es un nodo de Apps o Postgres gestionado?

El contenedor de Postgres del Compose es un nodo de base de Apps: una imagen, un volumen y una recuperación que operás vos. El Postgres gestionado es un clúster aparte, operado por el proveedor, desde $21.21 por mes por 1 vCPU, 1 GB de RAM y 10 GB. No reemplaza ese Postgres del Compose, que arranca con los roles, las extensiones y los scripts de Supabase.

### ¿Qué tiene que persistir?

Los datos de Postgres y los archivos de Storage. La desinstalación del Compose borra volumes/db/data y volumes/storage. En Unbroker cada uno va en un volumen. Un volumen no es un backup. Los backups van a un destino compatible con S3 que controlás, y conviene restaurar uno antes de confiar en él.

### ¿Cuáles son los requisitos mínimos?

La guía de Docker de Supabase lista 4 GB de RAM, 2 núcleos de CPU y un SSD de 40 GB como mínimo para todos los componentes, y 8 GB de RAM, 4 núcleos y un SSD de 80 GB como recomendación. Esos números son de esa instalación. Sacar servicios que no uses puede bajarlos. Esta nota no los traduce a un tamaño de servidor.

### ¿Kong sigue siendo el gateway por defecto?

No. Envoy es el API gateway por defecto. Kong es un override opcional. Studio y las APIs se abren por ese gateway en el puerto 8000.

### ¿En qué se diferencia de Supabase hospedado?

En la plataforma hospedada, Supabase opera el stack. Si lo hosteás vos, operás el host, los secretos, los backups, las actualizaciones y las URLs públicas. Si la base sigue en Supabase hospedado, las reglas de acceso se quedan ahí. Esta nota no compara precios.

## Related reading

- [Self-host de n8n](https://unbroker.cloud/es/blog/self-host-n8n)
- [Docker Compose en producción](https://unbroker.cloud/es/blog/docker-compose-to-production)
- [Postgres en producción](https://unbroker.cloud/es/blog/postgres-in-production)
- [Almacenamiento persistente y volúmenes](https://unbroker.cloud/es/blog/persistent-storage-volumes)
- [Postgres gestionado](https://unbroker.cloud/managed-databases/postgres)
- [Precios](https://unbroker.cloud/es/precios)
