Configurar Supabase no Windows

Os produtos ideais para este guia

Comece agora mesmo — peça o produto adequado e siga este guia passo a passo.

Introdução

Supabase é uma plataforma de desenvolvimento Postgres open-source que oferece um banco de dados Postgres completo, além de autenticação, APIs instantâneas, realtime e armazenamento, sendo uma alternativa open-source ao Firebase.

Pensando em hospedar esse serviço por conta própria? Vamos te guiar em cada passo para configurar e ajustar, além de tudo que você precisa saber para manter tudo rodando tranquilo.

Instale o Supabase com o Instalador One Click Apps

Você pode instalar o Supabase diretamente pelo nosso Instalador One Click Apps na interface web da sua VPS. Depois de finalizar a configuração inicial dos apps, abra o catálogo de apps, busque por Supabase e inicie a implantação com as configurações de projeto, ambiente e domínio que preferir. Isso te dá uma forma rápida e fácil de implantar e gerenciar o Supabase sem precisar configurar tudo manualmente via linha de comando, aproveitando a gestão integrada via web, suporte a domínios personalizados e provisionamento SSL onde disponível.

Pré-requisitos

Antes de instalar o Supabase, certifique-se que seu ambiente de hospedagem atende aos seguintes requisitos para garantir uma instalação tranquila e desempenho ideal.

Hardware	Mínimo	Recomendação ZAP-Hosting
CPU	1 núcleo vCPU	4 núcleos vCPU
RAM	4 GB	8 GB
Espaço em disco	25 GB	25 GB

O software exige que todas as dependências necessárias estejam instaladas e que rode em um sistema operacional suportado. Garanta que seu servidor atenda aos seguintes requisitos antes de continuar com a instalação:

Dependências: Git, Docker (Engine e Compose)

Sistema Operacional: Última versão do Ubuntu/Debian com suporte ao Docker 2

Confirme que todas as dependências estão instaladas e que a versão correta do sistema operacional está em uso para evitar problemas de compatibilidade durante a instalação do Supabase.

Preparação

Antes de configurar o Supabase, você precisa preparar seu sistema. Isso inclui atualizar seu sistema operacional para a versão mais recente e instalar todas as dependências necessárias. Essas preparações garantem um ambiente estável e ajudam a evitar problemas durante ou após a instalação.

Atualizar Sistema

Para garantir que seu sistema esteja rodando com as versões mais recentes de software e melhorias de segurança, sempre faça a atualização do sistema primeiro. Isso assegura que seu sistema tenha os patches de segurança e versões de software mais atuais antes de continuar.

Instalar dependências

Depois que o processo de atualização estiver concluído, você pode prosseguir com a instalação das dependências.

Git

Os dados do Supabase serão baixados via GitHub. Por isso, é necessário que o Git esteja instalado primeiro. Para isso, instale o Git para Windows no seu servidor.

Docker

O Supabase será implantado e executado na sua máquina usando um container Docker. Por isso, é necessário que o Docker esteja instalado primeiro. Para isso, instale o Docker Desktop no seu servidor.

Um passo a passo completo do processo de instalação e como usar o Docker está disponível no nosso guia Docker.

Instalação

Agora que todos os requisitos foram atendidos e as preparações necessárias concluídas, você pode prosseguir com a instalação do Supabase. Abra o prompt de comando. Baixe o repositório do Supabase, crie um diretório dedicado para o projeto e copie os arquivos Docker e o arquivo de ambiente de exemplo para ele.

git clone --depth 1 https://github.com/supabase/supabase
mkdir .\supabase-project

Copy-Item .\supabase\docker\* -Destination .\supabase-project -Recurse -Force
Copy-Item .\supabase\docker\.env.example -Destination .\supabase-project\.env -Force

Entre no diretório do projeto, puxe as imagens mais recentes dos containers e inicie a stack em modo destacado.

cd supabase-project
docker compose pull
docker compose up -d

Agora você pode acessar o Supabase Studio via http://<seu-ip>:8000. Será solicitado um nome de usuário e senha. Por padrão, as credenciais são:

Usuário: supabase
Senha: this_password_is_insecure_and_should_be_updated

Credenciais Padrão

Seu app está rodando com credenciais padrão. Proteja seus serviços o quanto antes usando as instruções abaixo.

Configuração

Nunca faça deploy com valores padrão ou de exemplo. Substitua todos os placeholders por segredos fortes e únicos, revise a configuração conforme suas necessidades de segurança e reinicie todos os serviços para aplicar as mudanças.

Gere chaves API seguras antes de expor qualquer serviço. Comece escolhendo um segredo JWT de 40 caracteres. Você pode usar o valor fornecido ou criar o seu próprio. Armazene esse segredo localmente em um local seguro. Não compartilhe e não faça commit em controle de versão. Use o segredo para gerar um JWT e depois derive as chaves API anon e service usando o formulário referenciado na documentação do Supabase: https://supabase.com/docs/guides/self-hosting/docker#generate-api-keys

Execute o formulário duas vezes para gerar ambas as chaves. Atualize seu ./docker/.env com:

ANON_KEY: chave anon
SERVICE_ROLE_KEY: chave service

Atualize os segredos obrigatórios em ./docker/.env. Esses valores devem estar definidos para um deploy funcional:

POSTGRES_PASSWORD: senha para o usuário postgres
JWT_SECRET: usado pelo PostgREST e GoTrue
SITE_URL: URL base do seu site
SMTP_*: credenciais do servidor de e-mail
POOLER_TENANT_ID: ID do tenant usado pelo pooler Supavisor

Proteja o Dashboard com novas credenciais antes do uso em produção. Edite ./docker/.env:

DASHBOARD_USERNAME: usuário do dashboard
DASHBOARD_PASSWORD: senha do dashboard

Você pode definir múltiplos usuários para o dashboard em ./docker/volumes/api/kong.yml:

basicauth_credentials:
  - consumer: DASHBOARD
    username: user_one
    password: password_one
  - consumer: DASHBOARD
    username: user_two
    password: password_two

Para habilitar todos os recursos do dashboard fora do localhost, defina SUPABASE_PUBLIC_URL em ./docker/.env para a URL ou IP que você usará para acessar o dashboard.

Aplique as mudanças de configuração reiniciando a stack:

docker compose down
docker compose up -d

Conclusão e mais Recursos

Parabéns! Você instalou e configurou com sucesso o Supabase na sua VPS/servidor dedicado. Também recomendamos dar uma olhada nos seguintes recursos, que podem te ajudar ainda mais durante a configuração do seu servidor:

Supabase.com - Site oficial
Supabase.com/docs/guides/self-hosting - Documentação Supabase

Tem dúvidas específicas que não foram abordadas aqui? Para mais perguntas ou suporte, não hesite em contatar nosso time de suporte, disponível diariamente para te ajudar! 🙂

Introdução​

Instale o Supabase com o Instalador One Click Apps​

Pré-requisitos​

Preparação​

Atualizar Sistema​

Instalar dependências​

Git​

Docker​

Instalação​

Configuração​

Conclusão e mais Recursos​