O Supabase é uma plataforma de desenvolvimento de código aberto para Postgres que oferece um banco de dados Postgres completo, além de autenticação, APIs instantâneas, recursos em tempo real e armazenamento — uma alternativa de código aberto ao Firebase.
O Supabase é composto por vários contêineres Linux. Em um Windows Server, esses contêineres não são executados diretamente, mas em um sistema Linux que você configura com o Subsistema do Windows para Linux (WSL2). Neste guia, mostramos como instalar o WSL2 com Ubuntu, configurar o Docker nele e iniciar o Supabase.
É mais fácil com um VPS Linux Em um VPS Linux (Debian ou Ubuntu), você instala o Supabase com apenas alguns cliques usando os Aplicativos com um clique na interface web do VPS ou manualmente, seguindo nosso guia Configurar o Supabase em um servidor Linux. Esse é o método que recomendamos: no Windows, o WSL2 também executa uma máquina virtual própria dentro do seu VPS, que consome memória e CPU e exige mais manutenção. Os Aplicativos com um clique não estão disponíveis em VPS Windows.
Antes de instalar o Supabase, verifique se o seu ambiente de hospedagem atende aos requisitos a seguir. O Windows e o ambiente WSL2 também precisam de recursos próprios, além dos usados pelo Supabase.
| Hardware | Mínimo | Recomendação da ZAP-Hosting |
|---|---|---|
| CPU | 2 núcleos vCPU | 4 núcleos vCPU |
| RAM | 8 GB | 16 GB |
| Espaço em disco | 60 GB | 80 GB |
Sistema operacional: Windows Server 2022 ou Windows Server 2025
Dependências: WSL2 com Ubuntu 24.04 e, dentro dele, Git e Docker (Engine and Compose)
Não use Docker Desktop nem contêineres do Windows O Docker Desktop não é compatível com o Windows Server. O Docker Engine do nosso guia Configurar o Docker em um Windows Server executa apenas contêineres do Windows e, por isso, não é adequado para o Supabase. Instale o Docker dentro do Ubuntu no WSL2, conforme descrito abaixo.
Conecte-se ao seu servidor como administrador usando a Área de Trabalho Remota (RDP). Abra o PowerShell como administrador e instale o WSL2 junto com o Ubuntu 24.04:
wsl --install -d Ubuntu-24.04
Em seguida, reinicie o servidor. Depois que ele reiniciar, abra o PowerShell novamente e inicie o Ubuntu uma vez com wsl -d Ubuntu-24.04. Na primeira inicialização, defina um nome de usuário e uma senha para o Linux.
A mensagem Nested virtualization is not supported on this machine pode aparecer durante a inicialização. Ela se aplica apenas a máquinas virtuais dentro do WSL e não afeta o Supabase.
Use wsl -l -v para verificar se o Ubuntu está em execução e usando a versão 2.
Execute todos os comandos a seguir no terminal do Ubuntu (wsl -d Ubuntu-24.04). Primeiro, atualize os pacotes e instale o Git:
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl
Instale o Docker Engine e o Docker Compose usando o script oficial de instalação do Docker:
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
Feche o terminal do Ubuntu com exit, execute wsl --shutdown no PowerShell e abra o Ubuntu novamente para que a associação ao grupo entre em vigor. Verifique a instalação com docker version e docker compose version.
Você encontra instruções detalhadas sobre como usar o Docker no Linux no nosso guia de Docker.
Quando todos os requisitos forem atendidos, você poderá instalar o Supabase. No terminal do Ubuntu, baixe o repositório do Supabase, crie um diretório próprio para o projeto e copie para ele os arquivos do Docker e o arquivo de ambiente de exemplo:
cd ~
git clone --depth 1 https://github.com/supabase/supabase
mkdir supabase-project
cp -rf supabase/docker/* supabase-project
cp supabase/docker/.env.example supabase-project/.env
Acesse o diretório do projeto, baixe as imagens atuais dos contêineres e inicie a stack em segundo plano:
cd supabase-project
docker compose pull
docker compose up -d
Agora você pode acessar o Supabase Studio no próprio servidor, pelo navegador, em http://localhost:8000. Será solicitado um nome de usuário e uma senha. Por padrão, as credenciais são:
- Nome de usuário:
supabase - Senha:
this_password_is_insecure_and_should_be_updated
Credenciais padrão Seu app está sendo executado com as credenciais padrão. Altere-as conforme descrito na seção Configuração antes de deixar o Supabase acessível externamente.
O WSL2 tem uma rede interna própria. Para acessar o Supabase Studio e a API pelo endereço IP do seu servidor, encaminhe a porta do Windows para o WSL. Primeiro, descubra o endereço IP interno do Ubuntu no PowerShell:
wsl -d Ubuntu-24.04 hostname -I
Em seguida, configure o encaminhamento e uma regra de firewall. Substitua [WSL-IP] pelo primeiro endereço exibido:
netsh interface portproxy add v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP]
New-NetFirewallRule -DisplayName "Supabase" -Direction Inbound -Protocol TCP -LocalPort 8000 -Action Allow
Agora você pode acessar o Supabase Studio em http://[deine-ip]:8000.
O endereço IP interno do WSL pode mudar depois de uma reinicialização. Nesse caso, verifique-o novamente e ajuste o encaminhamento com netsh interface portproxy set v4tov4 listenport=8000 listenaddress=0.0.0.0 connectport=8000 connectaddress=[WSL-IP].
O WSL encerra o Ubuntu quando nenhuma janela ou comando está acessando-o. Para manter o Supabase em execução, crie no Windows o arquivo C:\Users\<Benutzername>\.wslconfig com o seguinte conteúdo:
[general]
instanceIdleTimeout=-1
[wsl2]
vmIdleTimeout=-1
Em seguida, execute wsl --shutdown no PowerShell e reinicie o Ubuntu. Os contêineres do Supabase serão iniciados automaticamente assim que o Docker estiver em execução no Ubuntu.
Para que o Supabase também inicie após a reinicialização do servidor, crie uma tarefa no Agendador de Tarefas para ser executada na inicialização do sistema com sua conta de administrador (opção Executar independentemente de o usuário estar conectado). Na ação, informe wsl.exe com os argumentos -d Ubuntu-24.04 -u root -- systemctl start docker.
Parabéns! Você instalou e configurou o Supabase com sucesso no seu Windows Server usando o WSL2. Também recomendamos que você consulte estes recursos, que podem ajudar na configuração do servidor:
- Supabase.com – Site oficial
- Supabase.com/docs/guides/self-hosting – Documentação do Supabase
- learn.microsoft.com/windows/wsl – Documentação da Microsoft sobre WSL
Tem alguma dúvida específica que não foi respondida aqui? Nossa equipe está à sua disposição todos os dias para ajudar — é só entrar em contato! 🙂