Como usar o WSL2 no Windows 11: guia para devs (2026)

Você é dev e usa Windows — sem julgamentos, é a realidade de boa parte do mercado brasileiro. Mas em algum momento você já precisou rodar um script Bash, configurar um ambiente Django, usar ferramentas que simplesmente assumem que você está no Linux. A solução clássica era dual-boot ou uma VM pesada. Em 2026, existe algo bem melhor: o WSL2 (Windows Subsystem for Linux 2).

O WSL2 deixa você abrir um terminal Ubuntu (ou Debian, ou Fedora) direto no Windows 11, sem reiniciar, sem máquina virtual travando, sem abrir mão das suas ferramentas Windows. Você pode rodar npm install, python manage.py runserver e docker compose up no mesmo ambiente onde usa o Slack e o Chrome. Este guia explica tudo do zero para você que ainda não configurou o WSL2 — ou configurou mas nunca entendeu direito o que estava fazendo.

O que é o WSL2 e por que você deveria usar

O WSL2 é uma camada de compatibilidade desenvolvida pela Microsoft que roda um kernel Linux real dentro de uma máquina virtual ultra-leve, integrada diretamente ao Windows. A diferença para a versão anterior (WSL1) é significativa: o WSL2 usa Hyper-V para virtualização, o que significa compatibilidade quase total com chamadas de sistema Linux, desempenho muito superior e suporte nativo ao Docker.

Para um desenvolvedor brasileiro, os ganhos práticos são diretos:

• Rodar qualquer stack Linux sem dual-boot — Django, Rails, Node.js com ferramentas Unix, scripts shell, tudo funciona sem gambiarras.
• Docker sem dor de cabeça — o Docker Desktop usa o WSL2 como backend, tornando containers muito mais rápidos e estáveis do que a solução anterior baseada em Hyper-V puro.
• Integração perfeita com VS Code — a extensão oficial WSL da Microsoft deixa você editar arquivos Linux com toda a inteligência do editor, sem copiar nada para o Windows.
• Zero overhead na inicialização — diferente de uma VM, o WSL2 inicia em segundos e vive em segundo plano enquanto você usa o sistema normalmente.
• Compatibilidade com ferramentas de mercado — muitas bibliotecas Python e ferramentas DevOps têm suporte melhor (ou exclusivo) no Linux. No WSL2 você usa essas ferramentas sem adaptações.

Se você já leu nosso guia sobre Windows 11 para home office, sabe que o sistema já vem bem equipado para trabalho remoto. O WSL2 é o próximo passo natural para quem trabalha com desenvolvimento de software.

Requisitos mínimos para o WSL2

Antes de instalar, confirme que seu sistema atende:

• Windows 11 em qualquer edição (Home, Pro, Education). Para Windows 10, precisa da versão 2004 ou superior — mas se você ainda está no 10, vale considerar atualizar para o Windows 11 primeiro.
• Virtualização habilitada na BIOS/UEFI — em máquinas modernas isso já vem ligado. Você pode verificar no Gerenciador de Tarefas, aba "Desempenho", seção "CPU": procure "Virtualização: Habilitada".
• Pelo menos 4 GB de RAM — recomendado 8 GB ou mais para usar WSL2 junto com Docker.
• Espaço em disco — o Ubuntu básico ocupa cerca de 2 GB, mas projetos e pacotes crescem rapidamente. Reserve pelo menos 20 GB livres.

Como instalar o WSL2 no Windows 11

A instalação ficou muito mais simples a partir do Windows 11. Um único comando faz tudo. Siga estes passos:

Passo 1: abrir o PowerShell como administrador

Clique no botão Iniciar, digite PowerShell, clique com o botão direito no resultado e escolha Executar como administrador. Confirme o prompt do UAC.

Passo 2: rodar o comando de instalação

No PowerShell, digite o comando abaixo e pressione Enter:

wsl --install

Esse único comando faz tudo: habilita os recursos necessários do Windows (Plataforma de Máquina Virtual e Windows Subsystem for Linux), baixa o kernel Linux mais recente e instala o Ubuntu como distro padrão. O processo leva alguns minutos dependendo da sua conexão.

Passo 3: reiniciar o computador

Após a instalação, o Windows vai pedir para reiniciar. Faça isso — é obrigatório para que as mudanças entrem em vigor. Depois de reiniciar, o Ubuntu vai abrir automaticamente para concluir a configuração.

Passo 4: criar seu usuário Linux

Na primeira abertura, o Ubuntu vai pedir para você criar um nome de usuário e senha para o ambiente Linux. Esse usuário é completamente independente da sua conta Windows. Escolha um nome simples (sem espaços, letras minúsculas) e uma senha que você consiga lembrar — ela será pedida sempre que você usar sudo.

Pronto. Você já tem um terminal Linux funcionando no seu Windows 11.

Escolhendo uma distro diferente do Ubuntu

O Ubuntu é instalado por padrão e é a escolha certa para a maioria dos casos — tem a maior comunidade, mais tutoriais disponíveis (inclusive em português) e suporte LTS de longo prazo. Mas se você tem uma preferência, o WSL2 suporta várias opções.

Para ver todas as distros disponíveis para instalação, rode no PowerShell:

wsl --list --online

Para instalar uma distro específica, use a flag -d seguida do nome:

wsl --install -d Debian

As opções mais populares entre devs brasileiros são:

• Ubuntu 24.04 LTS — padrão, mais documentado, suporte até 2029. Ideal para quem está começando ou quer menos atrito.
• Debian — mais minimalista que o Ubuntu, extremamente estável. Boa opção para servidores ou quem prefere instalar apenas o que usa.
• openSUSE Tumbleweed — rolling release, sempre atualizado. Para quem quer estar na frente sem abrir mão de estabilidade.
• Kali Linux — voltado para segurança e pentest. Disponível na Microsoft Store para quem trabalha nessa área.

Você pode ter múltiplas distros instaladas simultaneamente. Para ver o que está instalado e qual está ativa:

wsl --list --verbose

Primeiras configurações após a instalação

Com o Ubuntu aberto, a primeira coisa a fazer é atualizar os pacotes do sistema. Isso garante que você está com as versões mais recentes de tudo que já veio instalado:

sudo apt update && sudo apt upgrade -y

A flag -y confirma automaticamente todas as atualizações sem pedir interação. Isso vai levar alguns minutos na primeira vez.

Em seguida, instale ferramentas essenciais para desenvolvimento:

sudo apt install -y build-essential curl git wget unzip

O pacote build-essential traz o compilador GCC e ferramentas de build necessárias para muitas bibliotecas nativas. O curl e wget são usados em scripts de instalação de praticamente tudo — Node.js, Python, Rust, etc.

Configurar o Git

O Git dentro do WSL2 é independente do Git instalado no Windows. Configure seu nome e email:

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

Se você usa chaves SSH para o GitHub ou GitLab, pode gerar uma nova chave dentro do WSL2 ou copiar sua chave existente do Windows para ~/.ssh/. Muitos devs preferem ter chaves separadas para manter os ambientes organizados.

Integração com o VS Code

A experiência de desenvolvimento no WSL2 atinge outro nível quando combinada com o VS Code. A Microsoft criou uma extensão oficial chamada WSL (anteriormente Remote - WSL) que permite abrir qualquer pasta do ambiente Linux diretamente no editor, com todas as extensões, IntelliSense e terminal funcionando no contexto Linux.

Para configurar:

1. Instale o VS Code no Windows normalmente (se ainda não tiver).
2. Abra o VS Code, vá em Extensões (Ctrl+Shift+X) e busque por "WSL". Instale a extensão da Microsoft.
3. No terminal WSL2, navegue até a pasta do seu projeto e rode: code .
4. O VS Code vai abrir no Windows, mas conectado ao ambiente Linux — você verá "WSL: Ubuntu" no canto inferior esquerdo.

A diferença prática é enorme: extensões como ESLint, Prettier e linters Python rodam diretamente no Linux, sem o overhead de tradução de caminhos de arquivo. O terminal integrado do VS Code abre automaticamente no shell da sua distro. É a experiência mais próxima de desenvolver em um Mac ou Linux nativo que você vai encontrar no Windows.

Dica: instale extensões diretamente no contexto WSL quando o VS Code perguntar "Instalar no WSL: Ubuntu" — isso garante que elas tenham acesso total ao ambiente Linux.

Navegando entre os sistemas de arquivos

Entender como os dois sistemas de arquivos se comunicam evita muita confusão no dia a dia.

Acessando o Windows a partir do Linux

Dentro do terminal WSL2, os discos do Windows ficam montados em /mnt/:

• /mnt/c/ — seu disco C:
• /mnt/d/ — disco D: (se existir)
• /mnt/c/Users/SeuNome/Desktop — sua área de trabalho Windows

Você pode listar, copiar, mover e editar arquivos Windows diretamente do terminal Linux. Por exemplo, para copiar um arquivo da sua área de trabalho para o home Linux:

cp /mnt/c/Users/SeuNome/Desktop/script.py ~/scripts/

Acessando o Linux a partir do Windows

No Windows Explorer, você verá uma entrada "Linux" na barra lateral esquerda após instalar o WSL2. Clicando nela, você acessa o sistema de arquivos das suas distros. O caminho de rede equivalente é:

\\wsl$\Ubuntu\home\seu-usuario

Você pode inclusive mapear esse caminho como uma unidade de rede no Windows para acesso mais rápido.

Atenção ao desempenho

Aqui vai uma dica importante que muita gente aprende do jeito difícil: nunca mantenha seus projetos em /mnt/c/ se você pode evitar. O acesso a arquivos NTFS pelo WSL2 tem overhead significativo porque há uma camada de tradução entre os dois sistemas de arquivos. Um npm install em /mnt/c pode ser 5 a 10 vezes mais lento do que o mesmo comando em /home/. Mantenha seus projetos dentro do Linux (~/projetos/) e acesse-os do Windows via Explorer ou VS Code Remote quando necessário.

Rodando servidores web no WSL2

Uma das dúvidas mais comuns de quem começa com WSL2 é: "se o servidor roda no Linux, como acesso pelo browser do Windows?" A resposta é simples — funciona automaticamente.

Quando você sobe um servidor no WSL2, o Windows 11 faz o encaminhamento de porta automaticamente. Se o seu servidor Django está rodando na porta 8000:

python manage.py runserver

Você abre o Chrome ou Firefox no Windows e acessa http://localhost:8000 normalmente. O mesmo vale para servidores Node.js, Flask, Rails ou qualquer outro que escute em uma porta local.

O encaminhamento automático funciona para a maioria dos casos. Em situações específicas (como servidores que escutam em uma interface de rede não padrão), você pode precisar ajustar configurações no arquivo /etc/wsl.conf da distro ou nas configurações de rede do WSL.

Para encontrar o endereço IP do WSL2 manualmente (útil para acesso de outros dispositivos na rede local), rode dentro do terminal Linux:

ip addr show eth0 | grep "inet "

Docker com WSL2 backend

O Docker Desktop para Windows usa o WSL2 como backend desde 2021, e a diferença de desempenho em relação à versão antiga baseada em Hyper-V puro é perceptível. Com o WSL2 backend habilitado, containers iniciam mais rápido, volumes têm melhor throughput e o consumo de memória é mais controlado.

Para configurar, instale o Docker Desktop normalmente no Windows. Durante a instalação, ele vai perguntar se deve usar o backend WSL2 — confirme que sim. Depois, em Settings → Resources → WSL Integration, habilite a integração com sua distro preferida (Ubuntu, por exemplo). A partir daí, você pode rodar docker e docker compose diretamente no terminal Linux do WSL2.

Para verificar que está tudo funcionando, abra o terminal Ubuntu e rode:

docker run hello-world

Se aparecer a mensagem de boas-vindas do Docker, o setup está completo.

Dicas práticas para stacks comuns

Node.js e JavaScript

A forma recomendada de instalar Node.js no WSL2 é via nvm (Node Version Manager), que permite trocar de versão sem conflitos:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts

Com o nvm você pode ter Node 18, 20 e 22 instalados e alternar com nvm use 20. Ferramentas como Yarn, pnpm e PNPM funcionam normalmente após a instalação do Node.

Python e Django/Flask

O Ubuntu 24.04 já vem com Python 3 instalado. Para projetos Django ou Flask, use ambientes virtuais para isolar dependências:

sudo apt install -y python3-pip python3-venv
python3 -m venv .venv
source .venv/bin/activate
pip install django

O workflow de desenvolvimento no WSL2 para projetos Django é idêntico ao Linux nativo: manage.py runserver, manage.py migrate, celery worker — tudo funciona sem adaptações. Uma vantagem real para devs brasileiros que precisam replicar ambientes de produção em servidores Linux.

Scripts de automação e DevOps

Scripts Bash, ferramentas como jq, yq, htop, clientes de banco de dados via linha de comando (psql, mysql), ferramentas de infraestrutura como Terraform e kubectl — tudo que você normalmente rodaria em um servidor de produção Linux funciona diretamente no WSL2. Isso é especialmente útil para devs que trabalham com AWS, GCP ou Azure e precisam replicar scripts de deploy localmente.

Limitações que você deve conhecer

O WSL2 é impressionante, mas tem limitações reais que é melhor conhecer antes de depender demais dele:

• Desempenho de I/O em /mnt/c/ — como mencionado, acessar o sistema de arquivos NTFS pelo WSL2 é lento. Sempre que possível, trabalhe dentro do /home/ da distro.
• Consumo de memória — por padrão, o WSL2 pode usar até 50% da RAM do sistema. Em máquinas com 8 GB isso pode ser restritivo. Você pode limitar criando um arquivo %UserProfile%\.wslconfig com o conteúdo: [wsl2] na primeira linha e memory=4GB na segunda.
• Sem suporte a systemd por padrão (mas configurável) — o systemd, o gerenciador de serviços padrão no Ubuntu e Debian, pode ser habilitado no WSL2 adicionando systemd=true no /etc/wsl.conf. Sem isso, você não pode usar systemctl start nginx, por exemplo.
• Apps gráficos têm limitações — o WSLg permite rodar apps Linux com interface gráfica, mas o suporte não é perfeito para todas as aplicações, especialmente as que dependem de aceleração de hardware ou áudio complexo.
• USB e hardware específico — dispositivos USB não são acessíveis por padrão no WSL2. O projeto usbipd-win resolve isso para casos específicos, mas exige configuração adicional.

Personalizando o terminal WSL2

O Windows Terminal é o melhor lugar para usar o WSL2 no dia a dia. Ele já vem instalado no Windows 11 e reconhece automaticamente suas distros, criando abas separadas para Ubuntu, PowerShell e Command Prompt. Para torná-lo mais produtivo:

• Instale o Oh My Bash ou Oh My Zsh dentro do WSL2 para um shell mais informativo e com autocompletar melhorado.
• Configure o tema Dracula ou One Dark no Windows Terminal — ambos disponíveis nas configurações em "Esquemas de cor".
• Instale uma Nerd Font (como FiraCode Nerd Font ou JetBrains Mono Nerd Font) para ter ícones bonitos nos prompts do Oh My Zsh.
• Use tmux para manter sessões persistentes — especialmente útil quando você está monitorando servidores ou processos longos.

Se você gosta de deixar seu ambiente Windows bem organizado, confira também nosso guia sobre como personalizar a área de trabalho do Windows 11 — dá para ter um setup com terminal WSL2 integrado a um desktop clean e produtivo.

WSL2 vs dual-boot vs VM: quando usar cada um

Essa comparação é frequente entre devs que estão avaliando as opções:

• WSL2 — melhor escolha para desenvolvimento de software no dia a dia. Você fica no Windows, usa suas ferramentas normais, e tem acesso a um ambiente Linux completo quando precisa. Sem reinicialização, sem overhead pesado.
• Dual-boot — faz sentido se você precisa de acesso total ao hardware Linux (drivers específicos, GPU para machine learning com CUDA no Linux) ou se quer uma experiência Linux 100% pura. O problema é que requer reinicialização para trocar de sistema.
• VM tradicional (VirtualBox, VMware) — útil para testar sistemas operacionais diferentes ou ambientes isolados por segurança. Para desenvolvimento cotidiano, o WSL2 é mais eficiente e integrado.

Para a esmagadora maioria dos devs brasileiros que trabalham com desenvolvimento web, APIs, automação ou DevOps, o WSL2 é a melhor solução disponível hoje. Ele elimina o principal argumento para mudar de Windows para Linux no trabalho diário.

Quer saber mais sobre tirar o máximo do Windows 11 como ambiente de trabalho? Veja nosso guia completo de recursos do Windows 11 para produtividade e nossa configuração de home office no Windows 11.

Perguntas frequentes

O WSL2 funciona no Windows 11 Home?

Sim. O WSL2 está disponível em todas as edições do Windows 11 — Home, Pro, Education e Enterprise — desde que você tenha a versão 22H2 ou mais recente instalada. Não é necessário nenhuma licença adicional.

Qual é a diferença entre WSL1 e WSL2?

O WSL1 traduzia chamadas de sistema Linux em chamadas Windows em tempo real — útil, mas com compatibilidade incompleta. O WSL2 usa um kernel Linux real rodando dentro de uma máquina virtual leve (Hyper-V), o que garante compatibilidade total com o ecossistema Linux, suporte a Docker sem gambiarras e desempenho muito superior para projetos que ficam dentro do sistema de arquivos Linux.

Posso rodar Docker no WSL2 sem o Docker Desktop?

Sim. É possível instalar o Docker Engine diretamente dentro da distro Linux do WSL2 usando o script oficial de instalação. Porém, para a maioria dos devs o Docker Desktop com o backend WSL2 é mais prático: oferece interface gráfica, gerencia volumes e redes automaticamente e integra bem com o VS Code. A escolha depende do quanto você quer controle manual versus conveniência.

Meus arquivos criados no WSL2 são acessíveis pelo Windows Explorer?

Sim. O Windows Explorer tem uma entrada "Linux" na barra lateral que permite navegar pelo sistema de arquivos da sua distro. O caminho UNC é \\wsl$\Ubuntu\home\seu-usuario. O oposto também funciona: dentro do terminal Linux, os discos do Windows ficam em /mnt/c, /mnt/d, etc. Para melhor desempenho, mantenha os arquivos de projeto dentro do sistema de arquivos Linux (/home/...) e acesse-os via VS Code Remote.

O WSL2 consegue rodar aplicativos gráficos Linux?

Sim, com o WSLg (Windows Subsystem for Linux GUI), que já vem habilitado por padrão no Windows 11. Isso significa que você pode abrir apps como o GIMP, Gedit ou até o navegador Firefox compilado para Linux diretamente no seu desktop Windows, sem precisar de servidor X11 externo. O suporte é razoável para uso cotidiano, mas jogos pesados ou apps OpenGL avançados ainda têm limitações.

Como faço para remover uma distro instalada no WSL2?

Abra o PowerShell ou o Prompt de Comando e rode: wsl --unregister NomeDaDistro (por exemplo, wsl --unregister Ubuntu). Isso remove completamente a distro e todos os seus arquivos. Para só parar sem desinstalar, use wsl --terminate NomeDaDistro. Você pode listar todas as distros instaladas com wsl --list --verbose.

O desempenho do WSL2 é próximo de um Linux nativo?

Para operações dentro do sistema de arquivos Linux (compilar código, rodar servidores, instalar pacotes), o desempenho é muito próximo de uma máquina Linux nativa. A diferença aparece principalmente quando você acessa arquivos no /mnt/c/ — ou seja, o sistema de arquivos NTFS do Windows — porque a tradução entre os dois sistemas tem overhead. A recomendação é sempre manter os arquivos de projeto dentro do /home/ da distro.