Executar Supabase localmente com a CLI

Prepare o diretório

Use um diretório de desenvolvimento com Node.js compatível com a CLI e um runtime de containers ativo. Consulte os requisitos da versão instalada. A primeira inicialização baixa imagens e precisa de espaço em disco.

1
npm install supabase --save-dev
2
npx supabase --version
3
npx supabase init

Versione o lockfile para registrar a versão utilizada pelo projeto. Confira o diretório supabase criado pela CLI. Não copie credenciais de produção para esse ambiente de estudo.

Restrinja o acesso à máquina

No Docker, você pode criar uma rede com os serviços publicados em loopback:

1
docker network create -o 'com.docker.network.bridge.host_binding_ipv4=127.0.0.1' local-network
2
npx supabase start --network-id local-network
3
npx supabase status

Se a rede já existir, confira sua configuração em vez de recriá-la. Use os endereços exibidos pela CLI para abrir o Studio e configurar o cliente. Os valores locais diferem do projeto Cloud. Não publique a saída de status, pois ela pode conter credenciais.

Confira os serviços

Abra o Studio local, crie uma tabela de teste e consulte a API com as credenciais locais. Confirme que a URL da aplicação aponta para a máquina de desenvolvimento. Se houver conflito de portas, revise a configuração local e reinicie os serviços conforme a referência da CLI.

Para parar os serviços locais, execute npx supabase stop. Consulte a referência da CLI antes de executar opções que removem volumes ou backups. O comando db reset recria o banco local e apaga registros que não estejam nas migrations e seeds.

Mantenha os ambientes separados

A CLI local serve para desenvolvimento. Para publicar sua aplicação, recomendamos conectar o backend ao Supabase SaaS. Não exponha o Studio local na internet. A hospedagem própria só é indicada com administração profissional e não é ensinada neste portal.