Windows Subsystem for Linux

O Windows Subsystem for Linux (WSL) é uma ferramenta de código aberto apoiada pela Microsoft que permite a emulação de um sistema operacional Linux dentro do Windows. A atual versão na data de escrita deste livro é a WSL 2, que traz grandes melhorias em relação à versão anterior.

O WSL permite instalar diversas distribuições Linux, até mesmo concomitantemente. Este guia oficial da Microsoft mostra algumas opções. Para este guia, vamos instalar a distribuição Fedora 43.

Instalando o WSL

Primeiramente, devemos instalar o WSL propriamente dito. Para isso, abra o PowerShell e execute o comando abaixo.

1
wsl.exe --install --no-distribution

Terminal do PowerShell, em que se executa o comando de instalação do WSL, inicialmente sem instalar alguma distribuição. — Processo de instalação do WSL pelo PowerShell.

Então, reinicie o computador para aplicar as mudanças.

Instalando o Fedora

Agora que o WSL está habilitado, podemos instalar a distribuição Fedora, segundo seu manual oficial.

Para fazer isso, abra o PowerShell e execute o comando abaixo.

1
wsl --install FedoraLinux-43 --name fedora

Criação de usuário

O WSL solicitará que você digite o nome de usuário desejado para usar dentro do Fedora Linux. Eu defini o mesmo username que o utilizado pela minha instalação do Windows: gabriel. Fique à vontade para escolher o seu.

Agora, vamos definir uma senha para o seu usuário do Linux. Digite o comando abaixo no terminal e pressione Enter Enter . Um detalhe é que, nos sistemas Linux, a senha não aparece enquanto você digita, fica apenas o espaço em branco mesmo. Não se preocupe, digite-a até o final e pressione Enter Enter . Após repetir a senha, pressione Enter Enter novamente.

1
sudo passwd $USER

Terminal do WSL, em que são exibidos os prompts para definição da senha do usuário. — Processo de definição da senha do Fedora pelo terminal.

Lembre-se da sua senha, pois ela será solicitada sempre que você precisar de permissões de administrador.

Definindo o Fedora como padrão

Agora, feche essa janela do Powershell e abra uma nova.

Então, digite o comando abaixo para definir o Fedora recém-instalado como a distribuição padrão do WSL.

1
wsl -d fedora

Após instalar o WSL, você poderá abri-lo diretamente pela entrada criada no Menu Iniciar do Windows, chamada WSL. Ela terá o ícone de um pinguim azul.

Esqueci a senha do meu usuário no WSL

Em caso de esquecimento da senha do usuário dentro do WSL, você pode trocá-la por meio de um acesso como o usuário root. Para isso, execute o seguinte comando no PowerShell.

1
wsl --user root

Então, execute o comando de redefinição de senha, mas digitando seu usuário em vez de [YOUR_USERNAME], sem os colchetes.

1
sudo passwd [YOUR_USERNAME]

Atualizando os pacotes

A maioria das ferramentas que você instalará no Fedora será por meio do gerenciador de pacotes dnf.

Para atualizar os pacotes abra o WSL por meio da entrada criada no Menu Iniciar. Então, execute o comando abaixo.

1
sudo dnf upgrade

A palavra sudo é usada para executar um comando com permissões de administrador. Ela provavelmente solicitará a senha do usuário que você criou anteriormente.

Quando perguntado se deseja continuar, pressione y y e então Enter Enter para confirmar. Isso pode ocorrer mais de uma vez durante a instalação.

Terminal do Fedora, primeira captura da execução do comando "sudo dnf upgrade". — Instalando as versões atualizadas dos pacotes do Fedora.

Terminal do Fedora, segunda captura da execução do comando "sudo dnf upgrade". — Instalando as versões atualizadas dos pacotes do Fedora.

Conectando os diretórios

Tanto o Linux, como também o Windows, possuem uma pasta especial para cada usuário do sistema, em que ficam guardados seus arquivos e em que se instalam os programas no modo usuário. Costumamos chamar essa pasta de “home”.

Em cada um dos sistemas, essa pasta fica em lugares diferentes. E, mesmo quando instalamos o WSL, ainda vai haver uma pasta para seu usuário do Windows na localização determinada pra ela, e outra pasta diferente para seu usuário do Linux, em outra localização determinada para ela.

Essas pastas são tão importantes que elas têm variáveis de ambiente específicas que apontam para si. No Linux e no Windows, essas variáveis são chamada de HOME, mas elas vão apontar cada uma para a sua pasta específica.

Vamos testar isso. Abra o PowerShell em uma janela, e o WSL em outra.

Digite echo $HOME na janela do PowerShell e veja o que aparece. Então, digite o comando echo $HOME na janela do WSL e veja o que aparece.

Terminal do PowerShell, em que se executa o comando "echo $HOME". A resposta é "C:\Users\gabriel". — Comando para exibir a variável de ambiente HOME no Fedora e no PowerShell, respectivamente.

Terminal do Fedora, em que se executa o comando "echo $HOME". A resposta é "/home/gabriel". — Comando para exibir a variável de ambiente HOME no Fedora e no PowerShell, respectivamente.

De fato, eu uso o mesmo nome de usuário no Fedora e no Windows, mas o caminho da pasta do usuário é diferente porque se tratam de duas pastas completamente distintas.

O WSL cria todo um novo ambiente de emulação dentro do Windows, com suas próprias pastas e configurações. Mas como acessar esse ambiente?

Se tudo tiver sido instalado corretamente, você verá uma nova entrada no Explorador de Arquivos chamada Linux. Dentro dela, haverá uma pasta chamada fedora. Essa é justamente a pasta / (raiz) do Fedora, a qual mencionamos anteriormente.

Explorador de Arquivos do Windows aberto na pasta "Linux\fedora". — Pasta raiz do Fedora WSL exibida no Explorador de Arquivos.

Acesse pelo Explorador de Arquivos a pasta home. Ela contém todos os diretórios de usuários registrados no Fedora. No momento, existe apenas o usuário que criamos. No meu caso, é o gabriel. Clique com o botão direito nela, e selecione Fixar no Acesso rápido.

Abra a pasta do seu usuário. Garanta que os arquivos ocultos estejam sendo exibidos. Você pode fazer isso clicando em: Visualizar > Mostrar > Itens ocultos.

Passos instruindo como exibir arquivos ocultos no explorador de Arquivos do Windows. — Exibindo arquivos ocultos no Explorador de Arquivos.

Vemos que há alguns arquivos dentro do diretório do usuário. O arquivo .bashrc é o arquivo de configuração do Bash, o shell padrão do Fedora.

Link simbólico

O ideal quando se usa o WSL é deixar todos os seus arquivos e projetos dentro do diretório do usuário do Linux. Assim, tem-se uma performance melhor e evita-se problemas de compatibilidade.

Entretanto, pode ser chato ter que navegar até o diretório do usuário toda vez que você quiser acessar um arquivo. Para facilitar, você pode criar um link simbólico no Windows que aponta para alguma pasta dentro do Fedora.

Eu gosto de organizar meus projetos numa pasta chamada dev na raiz do diretório do usuário.

Para criar uma pasta com esse nome, abra o WSL e execute o comando abaixo.

1
mkdir -p ~/dev

Vamos criar um arquivo de texto dentro dessa pasta para testar o link simbólico.

1
echo "Hello, World!" > ~/dev/hello.txt

Terminal do Fedora, em que se executa comandos para criar a pasta "dev", se mover para dentro dela e criar um arquivo de texto. — Criando um arquivo de texto na pasta ~/dev do Fedora.

Então, abra no terminal um perfil do PowerShell como administrador e execute o comando abaixo para criar um link simbólico.

1
New-Item -ItemType SymbolicLink -Path "C:\Users\$env:USERNAME\dev" -Target "\\wsl$\fedora\home\$env:USERNAME\dev"

O resultado será como o seguinte.

1
 Diretório: C:\Users\gabriel
2

3

4
Mode                 LastWriteTime         Length Name
5
----                 -------------         ------ ----
6
d----l        31/03/2026     15:45                dev

Então, você poderá acessar a pasta dev diretamente pelo Explorador de Arquivos. Abra o Executar com Super + R Windows + R e digite %USERPROFILE% para acessar seu diretório de usuário no Windows.

Você verá verá que a pasta dev está lá, e que apresenta um ícone de atalho.

Explorador de Arquivos do Windows aberto na pasta do usuário, em que se exibe a pasta "dev" com um ícone de atalho. — Link simbólico mostrado na pasta do usuário do Windows.

Clique com o botão direito na pasta dev e selecione Fixar no Acesso rápido para tê-la sempre à mão.

Ao acessar a pasta, você verá o arquivo hello.txt que criamos anteriormente no Fedora.

Explorador de Arquivos do Windows aberto na pasta "dev" do Fedora. — Pasta ~/dev do Fedora mostrada na estrutura de pastas do Windows.