# Hospedar Supabase: Postgres, Auth, Storage e o que você opera

Hospedar Supabase é um stack Docker, não um contêiner. Você opera Postgres, Auth, Storage, segredos, backups e a URL pública.

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

## A resposta curta

Hospedar Supabase é rodar um stack de Docker Compose, não um contêiner. Você opera os segredos, os backups, as atualizações e as URLs públicas. Os dados do Postgres e os arquivos do Storage precisam sobreviver a um contêiner novo.

Na Unbroker não existe um template do Supabase, e este texto não promete um. Os templates que existem estão no [índice de templates](https://unbroker.cloud/templates). Um app self hosted menor, com o próprio Postgres, é [hospedar n8n](https://unbroker.cloud/pt/blog/self-host-n8n). O mapa de um arquivo Compose para serviços está em [Docker Compose em produção](https://unbroker.cloud/pt/blog/docker-compose-to-production).

## O que significa hospedar

O guia de Docker do Supabase é a fonte do stack. A lista de arquitetura é Studio, Envoy, Auth, PostgREST, Realtime, Storage, imgproxy, postgres-meta, Postgres, Edge Runtime e Supavisor. Logflare e Vector não entram na configuração padrão. Ligá-los aumenta o consumo.

O Envoy é o API gateway padrão. O Kong é um override opcional, não o gateway que o setup inicial usa. O gateway escuta na porta 8000. REST, Auth, Storage e Realtime são caminhos desse mesmo gateway.

A instalação manual do guia clona uma tag `self-hosted/v*`. O exemplo da página é `self-hosted/v0.8.4`. Leia o guia de novo para a tag vigente. As imagens de um snapshot são testadas juntas. Trocar a tag de uma única imagem é permitido, e a compatibilidade não é garantida. A fonte é [self-hosting with Docker](https://supabase.com/docs/guides/self-hosting/docker).

Dá para remover serviços que você não usa, entre eles Realtime, Storage, imgproxy e Edge Runtime (`functions`), e tirar as dependências deles do Compose. Isso pode baixar o consumo. Também tira essas APIs.

## O que você opera

O `.env` de exemplo não é uma configuração para subir. O Supabase diz para não iniciar o stack com esses padrões. `generate-keys.sh` grava senhas e segredos. `add-new-auth-keys.sh` adiciona as API keys e o par de chaves assimétricas para assinar JWT. Os valores que você passa para uma aplicação são `POSTGRES_PASSWORD`, `SUPABASE_PUBLISHABLE_KEY`, `SUPABASE_SECRET_KEY` e `SUPABASE_PUBLIC_URL`. A secret key fica no servidor.

Três URLs precisam bater com o jeito como os clientes chegam no 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` é a URL base do dashboard, da API e do Storage. `API_EXTERNAL_URL` é a que o Auth usa para callbacks. `SITE_URL` é o redirect padrão do Auth. O início rápido no Linux também pede `PROXY_DOMAIN`. Atrás de um proxy TLS, a URL pública é `https://` na porta 443, não `:8000`.

O Studio usa HTTP basic auth. Defina `DASHBOARD_PASSWORD` antes da primeira subida. A senha precisa ter pelo menos uma letra. Só números não serve, e caracteres especiais também não. `DASHBOARD_USERNAME` é opcional.

O Postgres de um Supabase self hosted é o banco que esses serviços compartilham. O Supabase Storage, quando você hospeda, guarda os arquivos no disco do servidor por padrão, com um bind mount. Um backend compatível com S3 é outra configuração, não o padrão.

## Postgres: nó do Apps ou Postgres gerenciado

A Unbroker tem dois modelos de banco. Um nó de banco no Apps é um serviço privado a partir de uma imagem de banco. Você opera mais do motor: atualizações, usuários e a recuperação do volume. Um banco gerenciado é um cluster operado pelo provedor. A comparação está em [escolher um modelo de banco](https://docs.unbroker.cloud/databases/choose).

O contêiner de Postgres do Compose do Supabase é o primeiro modelo. Os scripts de migração de schema são montados em `/docker-entrypoint-initdb.d` e rodam quando esse contêiner sobe. Auth, Storage, Realtime e PostgREST esperam esse banco, os papéis e as extensões. O Postgres gerenciado não substitui esse contêiner. É um cluster que você provisiona para dados de uma aplicação, com o próprio plano e os dados de conexão.

O Postgres gerenciado exige Pro. O menor plano do catálogo é 1 vCPU, 1 GB de RAM e 10 GB de armazenamento, até 30 GB nesse plano, a $21.21 por mês. O armazenamento extra de um plano custa $0.30 por GB ao mês. O Pro custa $25 por mês com $25 de crédito de uso, e o preço do cluster é separado. O Free não inclui bancos gerenciados. O plano de 1 GB é um único nó. Nós de standby pedem um plano de pelo menos 2 GB de RAM. Leia o preço cotado na criação. A lista está em [Postgres gerenciado](https://unbroker.cloud/managed-databases/postgres). Operar o banco que você fica está em [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production).

## Volumes para Postgres e Storage

O script de desinstalação apaga o diretório de dados do Postgres `volumes/db/data` e os dados do Storage em `volumes/storage`. Esses são os dois armazenamentos que precisam sobreviver a um contêiner.

Na Unbroker um volume pertence a um serviço e é montado num caminho absoluto. Ele pode crescer, até 50 GB, e não pode encolher. Crescer não reinicia o serviço. Apagar o serviço apaga o volume e os dados. Um serviço com volume roda uma réplica. Arquivos fora do volume são temporários, porque um deploy, um restart ou um reagendamento pode trocar o contêiner.

Um volume não é um backup. O Cloud Apps pode enviar backups do volume para um destino compatível com S3 que você controla. Restaurar é outra ação, e você confirma com o nome do serviço. As regras estão em [armazenamento persistente](https://docs.unbroker.cloud/apps/storage) e em [armazenamento persistente e volumes](https://unbroker.cloud/pt/blog/persistent-storage-volumes).

## O gateway, o Studio e as URLs públicas

Publique o gateway. Deixe o resto privado. O Studio abre pelo gateway na porta 8000, e as APIs são caminhos dessa mesma porta: `/rest/v1/`, `/auth/v1/`, `/storage/v1/` e `/realtime/v1/`. Um serviço privado não tem URL pública. Outro serviço no mesmo ambiente usa o host e a porta desse serviço. Um preview não alcança a produção.

O guia do Supabase coloca um proxy reverso na frente do gateway quando você precisa de HTTPS. Na Unbroker, um domínio próprio e o TLS gerenciado exigem Pro. O hostname padrão continua. Os passos estão em [domínio próprio e HTTPS](https://unbroker.cloud/pt/blog/custom-domain-https). Coloque a URL que os clientes usam em `SUPABASE_PUBLIC_URL`, `API_EXTERNAL_URL` e `SITE_URL`. Não publique os segredos de exemplo nesse mesmo arquivo.

## Recursos mínimos

O guia de Docker do Supabase dá um mínimo para rodar todos os componentes, para desenvolvimento e para produção pequena ou média:

| Recurso | Mínimo | Recomendado |
| --- | --- | --- |
| RAM | 4 GB | 8 GB ou mais |
| CPU | 2 núcleos | 4 núcleos ou mais |
| Disco | SSD de 40 GB | SSD de 80 GB ou mais |

Esses números são do Supabase, para essa instalação Compose numa máquina. Não são um tamanho de servidor da Unbroker. Tirar serviços que você não roda pode reduzir o que o stack pede. Ligar Logs e Analytics acrescenta Logflare e Vector e aumenta a necessidade.

## Rodar na Unbroker

Mapeie o Compose como [Docker Compose em produção](https://unbroker.cloud/pt/blog/docker-compose-to-production) mapeia qualquer arquivo: um serviço por peça, segredos em variáveis de ambiente e só o gateway público. Um serviço de imagem puxa uma tag ou um digest fixado e roda uma réplica. Prefira a tag do snapshot que você testou. O passo a passo de Docker está em [fazer deploy de um contêiner](https://docs.unbroker.cloud/guides/deploy-docker).

Colar um arquivo Compose cria um serviço por entrada para imagens, ambiente, portas, comandos e um volume por serviço. Ele não decide o que é público e não transforma o Postgres do Supabase num cluster gerenciado. Revise cada serviço depois de colar.

O Free não consegue rodar este stack. Imagens, builds com Dockerfile, volumes persistentes e bancos gerenciados são Pro. Domínios próprios são Pro. Serviços Free rodam no runtime serverless, que não inclui imagens, Dockerfiles, volumes nem rede privada. O Pro custa $25 por mês com $25 de crédito de uso. O crédito não acumula. Se o uso fica abaixo do crédito, a cobrança continua $25. Os valores atuais estão em [preços](https://unbroker.cloud/pt/precos). As linhas do plano estão em [Plans](https://docs.unbroker.cloud/billing/plans).

Se o Compose precisa ficar numa máquina que você opera, esse host é um [servidor Linux na nuvem](https://unbroker.cloud/pt/servidores-cloud). Este texto não escolhe um tamanho. Os mínimos do Supabase acima são os requisitos do guia deles, não uma linha do catálogo.

## Backups, atualizações e rotação de segredos

`reset.sh` para o stack, remove os volumes do Docker e apaga os dados do Postgres e os arquivos do Storage. Isso é desinstalação, não backup.

Faça backup do volume do Postgres e do volume do Storage, e restaure um de cada antes de depender deles. Rotacionar uma chave sem uma cópia dos dados não devolve os arquivos. Se o app foi gerado em outro lugar e o banco continua no Supabase hospedado, as regras de acesso ficam nesse projeto. Esse corte está em [um app feito com IA em produção](https://unbroker.cloud/pt/blog/ai-built-app-to-production).

As atualizações seguem o `update.sh` do Supabase, que mistura um snapshot `self-hosted/v*` mais novo sobre os arquivos que você tem. Para mover um único serviço, troque a tag da imagem, faça pull e recrie esse serviço. O exemplo de Studio do guia é uma tag no formato `2026.04.27-sha-5f60601`. Fixe a tag que você pretende rodar. Uma tag mais nova no Docker Hub não é automaticamente o snapshot com o qual o resto do stack foi testado.

As API keys ficam no `.env`, não numa rotação do dashboard. `rotate-new-api-keys.sh --update-env` rotaciona `SUPABASE_PUBLISHABLE_KEY` e `SUPABASE_SECRET_KEY` sem mudar o par de chaves assimétricas, e depois você recria os serviços e atualiza as aplicações. Essa rotação não invalida os tokens de sessão que já existem. Regenerar o par assimétrico afeta as sessões ativas. `db-passwd.sh` muda a senha do banco e reescreve o `.env`. Depois, recrie o stack.

## Checklist

1. Comece pela tag `self-hosted/v*` vigente do guia de Docker, não pelos segredos de exemplo.
2. Rode os scripts de chaves antes da primeira subida. Defina uma senha do Studio com uma letra e sem caracteres especiais.
3. Configure `SUPABASE_PUBLIC_URL`, `API_EXTERNAL_URL` e `SITE_URL` com as URLs que os clientes usam.
4. Deixe os dados do Postgres e os arquivos do Storage em volumes. Faça backup num armazenamento que você controla e restaure uma vez.
5. Publique o gateway. Deixe os outros serviços privados.
6. Fixe cada imagem na tag ou no digest que você testou com o resto do stack.
7. Use o Pro. Imagens, Dockerfiles, volumes, domínios próprios e bancos gerenciados não estão no Free.
8. Não aponte o stack para o Postgres gerenciado esperando os papéis e os scripts de início do banco do Compose.

## Perguntas frequentes

### O que é preciso para hospedar Supabase?

O stack oficial de Docker Compose, segredos gerados em vez do .env de exemplo, URLs públicas para o Auth e a API, e armazenamento durável para o Postgres e para os arquivos do Storage. Na Unbroker isso pede Pro, porque imagens, Dockerfiles e volumes persistentes não estão no Free.

### Supabase self hosted é um único contêiner?

Não. O guia de Docker do Supabase descreve um stack: Studio, o API gateway, Auth, PostgREST, Realtime, Storage, imgproxy, postgres-meta, Postgres, Edge Runtime e Supavisor. Logflare e Vector são opcionais e vêm desligados.

### Quais serviços entram no stack Docker?

A lista de arquitetura é Studio, Envoy como gateway padrão, Auth, PostgREST, Realtime, Storage, imgproxy, postgres-meta, Postgres, Edge Runtime e Supavisor. Kong é um override opcional do gateway, não o padrão. Dá para remover serviços que você não usa, como Realtime, Storage, imgproxy ou Edge Runtime.

### Existe um template do Supabase em um clique na Unbroker?

Não. Não existe um template do Supabase. Os templates que existem estão no índice de templates. O template do n8n é outro produto. Não procure um botão de deploy do Supabase.

### Dá para hospedar Supabase no plano Free?

Não. O Free não inclui imagens de contêiner, builds com Dockerfile, volumes persistentes, domínios próprios nem bancos gerenciados. Serviços Free usam o runtime serverless, que não inclui rede privada. O Pro custa $25 por mês com $25 de crédito de uso.

### O Postgres do Supabase é um nó de Apps ou Postgres gerenciado?

O contêiner de Postgres do Compose é um nó de banco do Apps: uma imagem, um volume e uma recuperação que você opera. O Postgres gerenciado é um cluster separado, operado pelo provedor, a partir de $21.21 por mês para 1 vCPU, 1 GB de RAM e 10 GB. Ele não substitui esse Postgres do Compose, que sobe com os papéis, as extensões e os scripts do Supabase.

### O que precisa persistir?

Os dados do Postgres e os arquivos do Storage. A desinstalação do Compose apaga volumes/db/data e volumes/storage. Na Unbroker cada um fica num volume. Um volume não é um backup. Os backups vão para um destino compatível com S3 que você controla, e vale restaurar um antes de confiar nele.

### Quais são os requisitos mínimos?

O guia de Docker do Supabase lista 4 GB de RAM, 2 núcleos de CPU e um SSD de 40 GB como mínimo para todos os componentes, e 8 GB de RAM, 4 núcleos e um SSD de 80 GB como recomendação. Esses números são dessa instalação. Remover serviços que você não usa pode baixá-los. Este texto não traduz isso para um tamanho de servidor.

### O Kong ainda é o gateway padrão?

Não. O Envoy é o API gateway padrão. O Kong é um override opcional. O Studio e as APIs são acessados por esse gateway na porta 8000.

### Qual é a diferença para o Supabase hospedado?

Na plataforma hospedada, o Supabase opera o stack. No Supabase self hosted, você opera o host, os segredos, os backups, as atualizações e as URLs públicas. Se o banco continua no Supabase hospedado, as regras de acesso ficam lá. Este texto não compara preços.

## Related reading

- [Hospedar n8n](https://unbroker.cloud/pt/blog/self-host-n8n)
- [Docker Compose em produção](https://unbroker.cloud/pt/blog/docker-compose-to-production)
- [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production)
- [Armazenamento persistente e volumes](https://unbroker.cloud/pt/blog/persistent-storage-volumes)
- [Postgres gerenciado](https://unbroker.cloud/managed-databases/postgres)
- [Preços](https://unbroker.cloud/pt/precos)
