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. Para utilizar o WSL, é necessário seguir alguns passos iniciais.

1 - Habilitando os recursos necessários do Windows

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.

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.