Subsistema do Windows para Linux (WSL)

O WSL permite executar distribuições Linux no Windows (como Ubuntu, Debian, Arch Linux, etc) sem modificação, sem a sobrecarga de uma máquina virtual ou configuração em dual boot.

Visão Geral

• Requisitos

• Instalação

• Configuração

  • Global

  • Distro

  • Git

  • Docker

  • zsh

  • asdf

• Dicas e Truques

• Desinstalação

• Referências

Requisitos

• Windows 10 versão 2004 ou superior (Build 19041 ou superior) ou o Windows 11.

• Mínimo 8GB de RAM.

• Virtualização habilitada na BIOS.

Instalação

1. Habilite o recurso Subsistema do Windows para Linux e Plataforma de Máquina Virtual em Recursos do Windows ou execute os comandos abaixo como administrador no PowerShell:

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2. Ainda como administrador, execute o comando de instalação:

   wsl --install -d <Distribution Name>

   Distribuições Linux disponíveis:

   wsl --list --online

3. Reinicie o computador.

4. Na inicialização, será apresentada a janela de sua distro para definição do usuário.

5. Atualize os pacotes:

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

Configuração

Global

Definição de configuração global para todas as distribuições Linux WSL2.

1. Crie o arquivo .wslconfig na pasta do usuário no Windows:

   notepad %USERPROFILE%\.wslconfig

2. Copie e cole as linhas abaixo no arquivo. Exemplo:

   [wsl2]
   memory=8GB
   processors=1
   

3. Reinicie a distro após editar o arquivo:

   wsl --shutdown <Distribution Name>

Distro

Definição de configuração local para distro. Aplicado em ambos, WSL e WSL2.

1. No terminal da distro, crie o arquivo wsl.conf em /etc:

   sudo nano /etc/wsl.conf

2. Copie e cole as linhas abaixo no arquivo. Exemplo:

   [boot]
   systemd=true
   
   [automount]
   enabled = true
   root = /mnt
   

3. No terminal do Windows, reinicie a distribuição:

   wsl --shutdown <Distribution Name>

Dicas e Truques

Otimizando Disco Virtual (.vhdx) da Distribuição

• Optimize-VHD (Não funciona no Windows Home)**

Hyper-V deve estar habilitado para usar o comando Optimize-VHD.

Optimize-VHD -Path C:\Users\Natanael\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu_79rhkp1fndgsc\LocalState\ext4.vhdx -Mode Full
Optimize-VHD -Path C:\Users\Natanael\AppData\Local\Docker\wsl\data\ext4.vhdx -Mode Full

• DiskPart

1. Desligue a distribuição:

   wsl --shutdown <Distribution Name>

2. Abra o DiskPart:

   diskpart

3. Selecione o arquivo de disco virtual (.vhdx) do seu WSL. Verifique qual o caminho que está localizada na sua máquina seguindo como exemplo o caminho abaixo:

   select vdisk file="C:\Users\Natanael\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu_79rhkp1fndgsc\LocalState\ext4.vhdx"

4. Anexe o disco:

   attach vdisk readonly

5. Compacte:

   compact vdisk

6. Desanexe o disco e saia:

   detach vdisk
   exit

Desinstalar Distribuição

1. Siga para Configurações → Aplicativos → Aplicativos instalados → Selecione sua distro → Desinstalar.

2. Como administrador, abra o terminal e execute o comando:

   wsl --unregister <Distribution Name>

3. Reinicie o PC.

Desinstalar WSL

1. Siga para Configurações → Aplicativos → Aplicativos instalados → Selecione sua distro → Desinstalar.

2. Na mesma aba de aplicativos, procure por Windows Subsystem for Linux update e coisas parecidas com subs e linux, desinstale todas, cuidado pra não desinstalar seu sistema.

3. Desinstale os componentes do WSL2. Pesquise por Recursos do Windows, você deverá ver algo como Ativar ou desativar recursos do Windows, selecione e siga em frente. Desative Subsistema do Windows para Linux e Plataforma de Máquina Virtual.

4. Como administrador, abra o terminal e execute o comando:

   wsl --unregister <Distribution Name>

5. Reinicie o PC.

6. Após a desinstalação, pode ser que permaneça resíduos em sua máquina como o disco virtual (.vhdx) do seu WSL. Exclua, caso não tenha a pretensão de anexar esse disco em uma futura instalação.

   %UserProfile%\AppData\Local\Packages

   Procure por pastas com o nome da sua distribuição Linux, como CanonicalGroupLimited.Ubuntu_79rhkp1fndgsc e exclua.

Referências

https://learn.microsoft.com/pt-br/windows/wsl/install

https://pureinfotech.com/uninstall-wsl2-windows-10/

https://learn.microsoft.com/pt-BR/windows/wsl/wsl-config