Digite para filtrar as páginas da documentação.

    SetupVibe

    SetupVibe 2: instalação no Windows e uso com o WSL 2

    Instale o SetupVibe 2 no Windows e entenda a configuração do WSL 2. Confira os requisitos do binário nativo e o acesso aos serviços da distribuição Linux.

    O Windows não aceita o mesmo preparo de um Linux. O gerenciador de pacotes é outro e o shell é PowerShell. Boa parte das ferramentas que um projeto espera roda dentro do WSL. O SetupVibe trata os dois como alvos separados: o binário nativo prepara o Windows. O WSL recebe o binário Linux quando você entra na distribuição.

    Instalar no Windows

    O installer do Windows é um script PowerShell servido pelo branch v2. Ele lê a versão do canal, baixa setupvibe-windows-x64.exe, confere o SHA256SUMS, instala em %LOCALAPPDATA%\Programs\SetupVibe e acrescenta a pasta ao PATH do usuário.

    Terminal
    irm https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install.ps1 | iex

    Para passar argumentos ao binário, use a forma de scriptblock:

    Terminal
    & ([scriptblock]::Create((irm https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install.ps1))) auto

    No lançamento da v2, windows.setupvibe.dev servirá o mesmo arquivo. Até lá, o endereço acima é o que está publicado no branch v2. O endereço público continua apontando para o SetupVibe 1.

    O binário exige Windows x64 com build 22621 ou mais recente. Uma arquitetura fora de x64 e uma build anterior saem com 11, UNSUPPORTED_SYSTEM. Como o auto precisa instalar pacotes e alterar serviços, rode num PowerShell elevado. O binário não abre o UAC sozinho.

    O que entra no Windows

    O winget instala os utilitários: Git, PowerShell 7, Windows Terminal, 7-Zip, FFmpeg, ImageMagick, Nerd Font, nmap, Speedtest, btop e Tailscale. O servidor OpenSSH usa instalador próprio. Claude Code e Antigravity entram pelo instalador oficial de cada fornecedor.

    Os runtimes e as ferramentas de terminal entram pelo mise, igual ao Linux: Node, Python, Go, Rust, uv, Bun, pnpm, bat, eza, jq e ripgrep. O WSL entra como configuração, não como distribuição: o item wsl prepara a base e deixa a escolha da distribuição para você.

    O que não existe no Windows aparece como unavailable na lista. O auto não tenta instalar. ZSH, Oh My Zsh, Starship, tmux e os itens gráficos de desktop ficam de fora, porque o alvo é o shell nativo.

    O WSL

    Você escolhe se deseja instalar uma distribuição Linux no Windows. O SetupVibe não baixa Ubuntu nem Debian sozinho: ele prepara a base do WSL 2 e o arquivo de configuração que faz o resto funcionar.

    O auto grava um bloco em %USERPROFILE%\.wslconfig, depois de uma cópia de segurança, com rede espelhada, DNS por tunelamento, proxy automático, firewall ligado, recuperação gradual de memória e disco virtual esparso:

    [wsl2]
    networkingMode=mirrored
    dnsTunneling=true
    autoProxy=true
    firewall=true
    [experimental]
    autoMemoryReclaim=gradual
    sparseVhd=true

    A rede espelhada faz o WSL herdar as interfaces e a VPN do Windows. O tunelamento de DNS resolve o caso de VPN corporativa. O firewall do Hyper-V continua ligado com a política padrão de negar conexões de entrada: um serviço que roda dentro do WSL e responde ali não responde a partir do Windows até você abrir a porta.

    Isso é diferente do SetupVibe 1, que abria toda conexão de entrada. Para abrir só a porta necessária, num PowerShell elevado:

    Terminal
    New-NetFirewallHyperVRule -Name setupvibe-3000 -DisplayName setupvibe-3000 -Direction Inbound -VMCreatorId '{40E0AC32-46A5-438A-A0B2-2B479E8F2E90}' -Protocol TCP -LocalPorts 3000

    Para trabalhar por SSH ou Tailscale, prefira publicar na própria máquina e alcançar pelo túnel, sem abrir porta no firewall.

    O binário dentro do WSL

    O binário nativo do Windows cuida do Windows. Dentro de uma distribuição WSL, instale o binário Linux com o installer normal, como no capítulo de instalação:

    Terminal
    curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/promovaweb/setupvibe/v2/install.sh | sh

    A detecção reconhece o WSL pelo WSL_DISTRO_NAME ou pelo /proc/version. A lista da edição desktop já tem entradas para esse sistema. O que muda é a origem de alguns itens: no WSL, o Docker CLI pode ser dispensado quando o Docker Desktop do Windows já o fornece. O auto respeita essa condição.

    Diagnóstico no Windows

    setupvibe doctor confere o runtime, o estado, os itens e a saúde do component store com DISM /Online /Cleanup-Image /CheckHealth. A reparação lenta é explícita e demora:

    Terminal
    setupvibe doctor --repair-windows

    Ela roda DISM /RestoreHealth e depois sfc /scannow, exige PowerShell elevado e devolve 10 quando um dos dois falha. Um component store que não pode ser reparado exige a imagem de instalação da mesma build.

    Com reinício pendente no sistema, o auto termina com 20, REBOOT_PENDING. Com --reboot, ele cria a tarefa SetupVibeAutoResume, que roda o auto de novo com privilégio máximo depois do reinício e se apaga no fim.

    Se algo der errado

    Sintoma Causa provável O que fazer
    init ou auto param com 20 reinício pendente do Windows reinicie ou repita com --reboot
    doctor avisa do component store componentes corrompidos rode doctor --repair-windows num PowerShell elevado
    serviço no WSL não responde de fora firewall do Hyper-V nega a entrada abra só a porta necessária ou use túnel
    item marcado como unavailable aquele item não existe no Windows confira a tabela do docs inventory
    setupvibe: command not found pasta fora do PATH do usuário abra um terminal novo ou acrescente a pasta

    Próximo passo

    Windows e WSL têm o que precisam. O capítulo Vindo do SetupVibe 1 trata da máquina que já foi preparada pelo produto anterior e precisa migrar sem perder configuração.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano