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. Um app self hosted menor, com o próprio Postgres, é hospedar n8n. O mapa de um arquivo Compose para serviços está em Docker Compose em produção.

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.

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:

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.

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. Operar o banco que você fica está em Postgres em produção.

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 e em armazenamento persistente e 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. 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:

RecursoMínimoRecomendado
RAM4 GB8 GB ou mais
CPU2 núcleos4 núcleos ou mais
DiscoSSD de 40 GBSSD 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 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.

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. As linhas do plano estão em Plans.

Se o Compose precisa ficar numa máquina que você opera, esse host é um servidor Linux na nuvem. 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.

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.