Instruções para instalação do WSL no windows

Este procedimento tem como objetivo orientar a instalação e configuração do WSL 2 (Windows Subsystem for Linux) em sistemas Windows, permitindo a execução de distribuições Linux de forma integrada ao sistema operacional. Para utilizar o WSL (Windows Subsystem for Linux) no Windows, é necessário seguir alguns passos iniciais para habilitar os recursos do sistema que permitem a execução de distribuições Linux.

Primeiro, pesquise no Windows por Ativar ou desativar recursos do Windows. Isso abrirá uma janela com diversas opções que podem ser habilitadas ou desabilitadas.

1 - Habilitar recursos do Windows

Na janela de Ativar ou desativar recursos marque as seguintes opções:

• Hyper-V

• Plataforma de Máquina Virtual

• Plataforma do Hipervisor do Windows

• Subsistema do Windows para Linux

Após marcar as opções, clique em OK e aguarde enquanto o sistema aplica as alterações.

Ao término da instalação dos recursos, será solicitada a reinicialização do sistema. Reinicie o computador para que os recursos sejam ativados corretamente e o ambiente esteja pronto para a instalação do WSL.

wsl --status

Ou, se preferir, utilize:

wsl --version

Certifique-se de que a versão do WSL instalada é a versão 2.

Caso o WSL ainda não esteja instalado, você pode instalá-lo com o comando abaixo:

wsl --install -d Ubuntu

Esse comando iniciará o processo de download da distribuição Ubuntu através da Microsoft Store. Após o término do download e instalação, o terminal será iniciado automaticamente com o ambiente do Ubuntu.

Na primeira inicialização, será necessário aguardar a configuração do ambiente. Em seguida, você será solicitado a criar um nome de usuário e uma senha para a nova conta dentro do Ubuntu (essa conta é separada do usuário do Windows).

Após a criação do usuário, o ambiente estará pronto para uso, permitindo o acesso ao terminal Linux diretamente pelo Windows via WSL.

4 - Configurar recursos do WSL 2 via PowerShell

Com o WSL 2 instalado e a distribuição Ubuntu configurada, é possível ajustar os recursos de hardware alocados para o WSL através do arquivo de configuração `.wslconfig`.

Execute os comandos abaixo no PowerShell para criar ou adicionar as configurações no arquivo `.wslconfig`, localizado em `C:\Users\SEU_USUARIO\.wslconfig`:

Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "[wsl2]"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "memory=8GB"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "processors=3"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "[experimental]"
Add-Content -Path "$Env:USERPROFILE/.wslconfig" -Value "autoMemoryReclaim=dropcache"

Essas linhas irão criar (ou complementar, caso o arquivo já exista) o seguinte conteúdo no arquivo `.wslconfig`:

[wsl2]
memory=8GB
processors=3

[experimental]
autoMemoryReclaim=dropcache

Essa configuração define que:

- O WSL 2 poderá usar até **8 GB de RAM**. - Terá acesso a **3 núcleos de CPU**. - O recurso experimental **autoMemoryReclaim** será ativado para melhorar o gerenciamento de memória liberando cache automaticamente.

Após salvar essas configurações, **reinicie o WSL** para que as mudanças entrem em vigor. Você pode fazer isso com o seguinte comando no PowerShell:

wsl --shutdown

Depois disso, ao abrir novamente a distribuição Ubuntu, as novas configurações já estarão aplicadas.

5 - Configurar o WSL para usar o usuário root como padrão e ajustar o disco virtual

Agora que o Ubuntu foi instalado e as configurações de hardware foram ajustadas, você pode realizar outras personalizações, como configurar o **usuário root** como padrão ao iniciar o WSL e tornar o **tamanho do disco virtual** dinâmico.