Bora fazer isso do zero, completo: Windows 11 limpo → instalar WSL2 + Ubuntu → preparar todo ambiente (Node, Docker, Git, Stripe CLI, VS Code integrado).
1. Ativar e instalar WSL2
Abra o PowerShell como Administrador e rode:
wsl --install
Isso vai:
- Ativar o WSL2.
- Instalar o Ubuntu automaticamente (Ăşltima versĂŁo LTS).
Quando terminar, reinicie o PC.
Depois do reboot, abra o app “Ubuntu” (vai aparecer no Menu Iniciar).
👉 Na primeira execução, ele vai pedir para criar um usuário Linux (ex.: victor) e senha.
Teste:
wsl --version
Deve mostrar WSL versĂŁo 2.
2. Atualizar o Ubuntu
No terminal Ubuntu (dentro do WSL):
sudo apt update && sudo apt upgrade -y
3. Instalar Node.js 20 + npm
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
Teste:
node -v # deve mostrar v20.x
npm -v # deve mostrar 10.x
4. Instalar Git
sudo apt install -y git
Teste:
git --version # ex: git version 2.34.x
5. Instalar Docker Desktop (no Windows)
👉 Baixe e instale: Docker Desktop
Durante a instalação:
- Marque a opção “Enable WSL2 integration”.
Depois:
- Abra o Docker Desktop.
- Vá em
Settings > Resources > WSL Integration. - Habilite para a sua distro Ubuntu.
Teste no Ubuntu/WSL:
docker --version
docker-compose --version
Se der erro de permissĂŁo:
sudo usermod -aG docker $USER
exit
Depois, abra o Ubuntu de novo e rode docker ps.
6. Instalar Stripe CLI (no Windows)
👉 Baixe o instalador .msi aqui: Stripe CLI Releases
Depois, abra o PowerShell:
stripe --version
stripe login
O comando stripe login abre o navegador → conecte na sua conta Stripe.
7. Instalar VS Code e integrar com WSL
👉 Baixe o VS Code: Download
Dentro do VS Code:
- Instale a extensĂŁo “Remote – WSL”.
- Depois, abra o terminal do Ubuntu (
wsl), vá até a pasta do projeto e rode:code . - Isso abre o VS Code conectado dentro do WSL.
8. Clonar/Inicializar o projeto
Crie uma pasta de projetos no Ubuntu:
mkdir -p ~/projects && cd ~/projects
Clone seu repositĂłrio (ou crie um novo):
git clone https://github.com/seu-usuario/whats-affiliates-saas.git
cd whats-affiliates-saas
9. Configurar Docker Compose
O projeto já vai ter o docker-compose.yml que te mandei.
Basta subir:
docker-compose up -d
Testar:
docker ps
VocĂŞ deve ver containers rodando (db, api, web, proxy).
10. Configurar Prisma
Gerar e aplicar o schema:
docker-compose exec api npx prisma generate
docker-compose exec api npx prisma migrate dev --name init
11. Stripe Webhook (em desenvolvimento)
Em outro terminal (Windows/PowerShell ou Ubuntu mesmo):
stripe listen --forward-to http://api.localhost/billing/webhook
12. Testar acesso
- Frontend: http://app.localhost
- API: http://api.localhost/health
âś… Checklist final
- WSL2 instalado (Ubuntu rodando).
- Node.js v20 e npm funcionando no WSL.
- Git instalado no WSL.
- Docker Desktop instalado no Windows + integrado ao WSL.
- Stripe CLI instalado e logado no Windows.
- VS Code com extensĂŁo Remote – WSL para editar cĂłdigo direto do Ubuntu.
- Containers sobem com
docker-compose up -d. - Prisma gera banco e migrações.
- Stripe webhook funcionando.