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

De IT's Instruções de Trabalho - FAHOR/CFJL
Revisão de 15h57min de 16 de abril de 2025 por Huanan (discussão | contribs)
Ir para navegação Ir para pesquisar

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.

Recursos que devem ser ativados para uso do WSL

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.

2 - Instalando e configurando o WSL 2 e o Ubuntu

Após reiniciar o computador, siga os passos abaixo para instalar o WSL 2, a distribuição Ubuntu e aplicar algumas configurações de performance.

2.1 - Atualizar o WSL

Abra o PowerShell como administrador e execute: 

wsl --update

Esse comando garante que você está utilizando a versão mais recente do WSL disponível no sistema.

Em seguida, execute: 

wsl --status

ou 

wsl --version

Esses comandos exibem informações sobre a versão do WSL instalada. Verifique se a versão exibida corresponde ao WSL 2.

2.2 - Instalar a distribuição Ubuntu

Para instalar a distribuição Ubuntu, execute: 

wsl --install -d Ubuntu

Aguarde até a conclusão da instalação. A primeira inicialização pode demorar alguns minutos.

2.3 - Configurar recursos do WSL (ajustes de performance)

Você pode limitar a quantidade de memória e núcleos que o WSL 2 utilizará, além de ativar funcionalidades experimentais.

Execute os comandos abaixo no PowerShell: 

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 configurações serão salvas no arquivo:

C:\Users\SEU_USUÁRIO\.wslconfig

Você pode editar esse arquivo manualmente no futuro, se quiser ajustar os recursos.

2.4 - Definir usuário padrão como root

Para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL, execute: 

ubuntu config --default-user root
Disponível em “http://wiki.fahor.com.br/index.php?title=Instruções_para_instalação_do_WSL_no_windows&oldid=22304”