Ir para o conteúdo

Configurar o Supabase no Windows

Configure o Supabase em um Windows Server: instale o WSL2 com Ubuntu, configure o Docker, inicie o Supabase e deixe-o acessível externamente → Saiba mais

10 de novembro de 20266 min de leitura27 visualizações0 útil

Introdução

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.

Dica

É 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.

Requisitos

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.

HardwareMínimoRecomendação da ZAP-Hosting
CPU2 núcleos vCPU4 núcleos vCPU
RAM8 GB16 GB
Espaço em disco60 GB80 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)

Atenção

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.

Preparação

Instalar o WSL2 e o Ubuntu

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:

Code
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.

Informações

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.

Atualizar o sistema

Execute todos os comandos a seguir no terminal do Ubuntu (wsl -d Ubuntu-24.04). Primeiro, atualize os pacotes e instale o Git:

Code
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl

Instalar o Docker

Instale o Docker Engine e o Docker Compose usando o script oficial de instalação do Docker:

Code
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.

Instalação

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:

Code
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:

Code
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
Atenção

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.

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:

Code
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:

Code
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.

Informações

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].

Manter o Supabase em execução

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:

Code
[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.

Conclusão e outros recursos

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:

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

FAQ

Perguntas frequentes

O Supabase é executado como um conjunto de contêineres Linux. Em um Windows Server 2022 ou 2025, instale primeiro o WSL2 com Ubuntu, configure o Docker Engine e o Docker Compose e, em seguida, inicie o Supabase com docker compose. Os Aplicativos com um clique estão disponíveis apenas em VPS Linux.
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.
Como o Windows e o ambiente WSL2 também precisam de recursos, reserve pelo menos 2 núcleos vCPU, 8 GB de RAM e 60 GB de espaço em disco. A ZAP-Hosting recomenda 4 núcleos vCPU, 16 GB de RAM e 80 GB de espaço em disco.

Feedback

Este artigo foi útil?

Sua opinião nos ajuda a definir prioridades e a melhorar os conteúdos.

0 de 0 As avaliações consideraram este artigo útil.

Ajuda personalizada

As instruções não são suficientes?

A nossa equipe de suporte da ZAP conhece seu produto — descreva brevemente seu problema e ajudaremos pessoalmente.

O Zappy conhece este guia e te responde direto no chat.