Skip to main content

VPS: Configurar Supabase no Windows

Este guia foi criado com os seguintes produtos:

(Os detalhes podem variar com produtos de diferentes fornecedores, mas os conceitos principais permanecem os mesmos)

VPS

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.

img

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.

Requisitos​

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

HardwareMínimoRecomendação ZAP-Hosting
CPU1 núcleo vCPU4 núcleos vCPU
RAM4 GB8 GB
Espaço em disco25 GB25 GB

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

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

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

Verifique se todas as dependências estão instaladas e se 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 garante que seu sistema tenha os patches de segurança e versões de software mais atuais antes de continuar.

Instalar dependências​

Após o processo de atualização, você pode prosseguir com a instalação das dependências.

Git​

Os dados do Supabase serão baixados via GitHub. Para isso, o Git precisa estar 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. Para isso, o Docker precisa estar 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 de projeto dedicado 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 usuário e senha. Por padrão, as credenciais são:

  • Usuário: supabase
  • Senha: this_password_is_insecure_and_should_be_updated

img

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. Guarde esse segredo localmente em um lugar 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: consumido 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 do 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 o Supabase no seu VPS com sucesso. Também recomendamos dar uma olhada nos seguintes recursos, que podem te ajudar ainda mais durante a configuração do seu servidor:

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! 🙂

Cookie settings