O que é o Supabase e para que serve
O Supabase é uma plataforma de backend montada em volta de um banco Postgres completo, um por projeto. Em volta desse banco ficam serviços de código aberto que o frontend chama pela internet: uma API gerada a partir das tabelas, o login de usuários, o armazenamento de arquivos, as mensagens em tempo real e as funções em TypeScript.
Ficha e sumário da página
- Referência técnica
- Supabase CLI 3.1.0
- Revisão
- 15 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Um banco Postgres no centro de tudo
A documentação do Supabase resume o produto numa frase: todo projeto recebe um banco Postgres completo, sem camada de abstração por cima. Isso significa tabelas, colunas tipadas, chaves estrangeiras, funções, triggers e extensões do próprio Postgres, como o pgvector para vetores e o pg_cron para tarefas agendadas. O SQL que você já escreve funciona igual no Supabase.
Os outros serviços do Supabase giram em volta desse banco. O login guarda os usuários num schema próprio do Postgres. O armazenamento de arquivos registra cada objeto numa tabela. A API lê as tabelas que você cria. Por isso, quase toda configuração de permissão acaba numa política escrita em SQL, assunto da página Segurança, RLS e chaves.
O painel do projeto, chamado Studio, oferece duas portas de entrada para o banco. O Table Editor mostra as tabelas como planilhas, com colunas e linhas editáveis. O SQL Editor recebe instruções SQL e executa cada uma com acesso administrativo, um detalhe que pesa quando você compara o que aparece no painel com o que a aplicação recebe.
Os serviços em volta do banco
A documentação de arquitetura lista as peças do Supabase e o projeto de código aberto por trás de cada uma. A maior parte foi escrita pela própria Supabase. Algumas vêm de comunidades independentes, como o PostgREST e o Deno.
projeto SupabaseUma URL própria, as chaves de API e o painel Studio.Envoy (gateway)Recebe as chamadas da internet e encaminha cada uma ao serviço certo.PostgRESTTransforma as tabelas do banco numa API REST, com o pg_graphql para GraphQL.AuthCadastra usuários e emite os tokens de sessão.StorageGuarda arquivos compatíveis com S3 e registra os metadados no banco.RealtimeEnvia por WebSocket as mudanças nas tabelas, mensagens e presença.Edge FunctionsExecuta funções em TypeScript no runtime do Deno.SupavisorAgrupa as conexões diretas ao banco.PostgresAs tabelas da aplicação e os schemas dos serviços.
O frontend raramente conversa com o Postgres pela porta do banco. Ele chama a URL do projeto pelo HTTPS, com uma biblioteca cliente como a supabase-js. O gateway recebe a chamada e entrega ao serviço responsável: uma consulta vai para o PostgREST, um login vai para o Auth, um upload vai para o Storage. Conexões diretas, usadas por ferramentas de migração e por backends, passam pelo Supavisor.
A documentação registra os princípios por trás desse desenho. Cada peça precisa funcionar sozinha, apenas com um banco Postgres. As peças conversam por API e webhooks. O produto gerenciado precisa ser compatível com a versão self-hosted, para que um projeto entre e saia da plataforma com facilidade.
O que chega com cada projeto
Ao criar um projeto no painel, você escolhe a organização, o nome, a região e a senha do banco. A plataforma então provisiona o Postgres e os serviços. O projeto pronto expõe três itens que a aplicação usa: a URL da API, que aponta para aquele projeto, uma chave publishable, que pode ir para o navegador, além de uma chave secret, que fica só em servidores confiáveis.
As duas chaves têm papéis opostos. A publishable identifica a aplicação e respeita as políticas do banco. A secret entra com o papel service_role, que ignora essas políticas. Projetos antigos e tutoriais ainda mostram as chaves legadas anon e service_role, no formato de token. A documentação informa que elas seguem funcionando até você desativar cada uma no painel.
Um engano comum aparece aqui. Quando a aplicação aponta para a URL de um projeto e o painel mostra outro, a consulta chega a um banco válido sem as tabelas esperadas. O erro parece uma tabela ausente quando o problema está no endereço.
Supabase Cloud ou self-hosted
O Supabase existe em duas formas. No Supabase Cloud, a empresa opera a infraestrutura: servidores, sistema operacional, backups do Postgres e monitoramento. O modelo de responsabilidade compartilhada deixa com você o acesso à plataforma, o schema, as permissões das tabelas, os usuários e as chaves. O Cloud também traz recursos gerenciados, como backups diários e a recuperação até um ponto no tempo nos planos pagos. A documentação avisa que os backups cobrem o banco e deixam de fora os arquivos do Storage.
O self-hosted usa o mesmo código, com o Docker Compose como método recomendado pela documentação. A instalação própria roda um único projeto, configurado quase todo por variáveis de ambiente. Alguns recursos ficam de fora: branching, métricas avançadas, backups gerenciados com recuperação até um ponto no tempo, a Management API e os buckets de analytics e de vetores. Provisionar o servidor, atualizar os serviços, manter o Postgres, guardar backups e acompanhar a disponibilidade ficam com o administrador da instalação. O suporte vem da comunidade.
Para acompanhar as páginas deste portal, o Supabase Cloud concentra o trabalho nas tabelas, no login e nas permissões, sem um servidor para manter. O self-hosted faz sentido quando um requisito concreto de rede ou de infraestrutura exige essa liberdade e um profissional assume a administração contínua.
O ambiente local do CLI
O Supabase CLI sobe uma cópia da stack em containers no seu computador, com o mesmo Postgres e os mesmos serviços. Esse ambiente serve para desenvolver e testar migrations antes de aplicar as mudanças ao projeto no Cloud. A documentação é explícita: a stack local não recebeu o reforço de segurança de produção e não deve receber tráfego externo. As páginas deste portal usam como referência o Supabase CLI 3.1.0, publicado em 09/11/2026.
O banco é a primeira peça a conhecer, porque todas as outras dependem dele. A próxima página, Banco de dados e API, mostra como uma tabela criada em SQL vira uma rota da API.