DEV Community

Jean Dias
Jean Dias

Posted on

Configurando o WSL em menos de 15 minutos

#wsl #linux #windows #environment

Certo, irei partir do principio que seu Windows 10 esteja com todas as atualizações feitas, até a última versão disponível.

— O meu está na versão 21H1

Esse tutorial tem o objetivo instalar e deixar configurado o Windows Subsystem for Linux (WSL) em sua versão 2.

Em relação a ser em menos de 15 minutos, vai depender de sua maquina estar utilizando um SSD para o Windows reiniciar rápido e uma internet também rápida (a minha tem 300 Mbs) pois é baixado um conteúdo de 450MB em média.

Com todos os Updates feitos o primeiro passo é abrir o Windows PowerShell em modo Administrador. Para isso basta clicar com o botão direito no ícone do menu iniciar.

Image description

Após iniciar o Windows PowerShell, copie o comando abaixo e cole no terminal. Este comando irá instalar o Windows Subsystem for Linux (WSL)

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Enter fullscreen mode Exit fullscreen mode

Image description

Tecle Enter e aguarde alguns segundo para finalizar a instalação. Logo em seguida copie este outro comando e o cole no PowerShell. Este será responsável por instalar complementos para utilizar virtualização.

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
Enter fullscreen mode Exit fullscreen mode

Image description

Tecle Enter e novamente aguarde alguns segundos para finalizar a instalação. Após isto reinicie o computador para continuarmos a configuração do WSL.

Ao voltar para o Windows faça o download do pacote abaixo, que será responsável por atualizar o Kernel linux permitindo assim o uso da versão 2 do WSL.

https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

A instalação é bastantes simples, basta dar next e pronto.

Image description

Depois inicie o Windows PowerShell e copie e cole o comando abaixo, ele será responsável por habilitar o WSL 2 por padrão para qualquer distro linux.

wsl --set-default-version 2
Enter fullscreen mode Exit fullscreen mode

Image description

Após definido a versão 2 como padrão vamos instalar uma distro linux para utilizarmos como base. A partir deste ponto utilizar o WSL pode lhe parecer bastante similar a utilizar um server linux, visto que você terá a interface de linha de comando da distro selecionada.

Para instalar a distro pode utilizar o meio oficial, direto pela Microsoft Store, ou utilizar algum outro tutorial pela Internet para utilizar sua distro favorita.

Hoje está disponível as seguintes distros:

  • Ubuntu
  • OpenSUSE
  • Kali
  • Debian
  • Fedora Remix
  • Pengwin
  • Alpine WSL

Basta acessar a loja procurar sua distro favorita e instalar.

Image description

Depois execute o primeira inicialização da distro, no meu caso escolhi o Ubuntu, você poderá fazer pela própria loja ou procurando no menu Iniciar. Essa primeira execução você irá definir o seu usuário e senha do linux.

Image description

Após isso você pode iniciar o Windows PowerShell ou o novo Windows Terminal, que pode ser encontrado na própria Microsoft Store, e digitar o comando abaixo para verificar se o linux, foi instalado corretamente na versão WSL 2.

wsl --list -v
Enter fullscreen mode Exit fullscreen mode

Image description

E para finalizar basta digitar apenas **wsl **no Terminal para inciar.

wsl
Enter fullscreen mode Exit fullscreen mode

Image description

Pronto! Agora você já tem o WSL 2 rodando no seu Windows e pode usar as ferramentas do linux, servidor Nginx, Docker, PHP-cli, Node.js entre outros.

Dicas Bônus

Eu costumo fazer algumas configurações personalizadas, como alterar o ponto de montagem do diretório c: e também limitar a quantidade de recursos gastos pelo WSL.

Para alterar o ponto de montagem, que por padrão vem no /mnt eu edito o arquivo wsl.conf que fica dentro da pasta /etc, para isso eu digito o seguinte comando usando o vim mas pode ser alterado pelo nano se preferir.

sudo vim /etc/wsl.conf
Enter fullscreen mode Exit fullscreen mode

Image description

E adiciono o seguintes comandos:

[automount]
root = /
options = "metadata"
Enter fullscreen mode Exit fullscreen mode

O root = / *irá definir que não será montado mais em */mnt **e sim na raiz /, o options = “metadata”** faz um ajuste de permissões de arquivos para evitar o “famoso” 777.

E para limitar a quantidade de recursos edito o arquivo .wslconfig dentro da pasta do usuário no próprio Windows, no meu caso c:\Users\Jean.

vim .wslconfig
Enter fullscreen mode Exit fullscreen mode

Image description

E digito o conteúdo a seguir, que limita a quantidade de memória RAM e processador (CPU) que será utilizado. Geralmente coloco entre 25% a 40% de meus recursos.

[wsl2]
memory=4GB
processors=4
Enter fullscreen mode Exit fullscreen mode

Image description

E com isso você tem o básico para poder começar a desenvolver.

Qualquer dúvida ou sugestões podem deixar nos comentários abaixo.

UPDATE

Em versões mais recentes do Windows 10/11 basta utilizar o comando abaixo no terminal em modo Administrador, e logo em seguida reiniciar o computador para que o WSL2 seja instalado.

wsl --install -d Ubuntu
Enter fullscreen mode Exit fullscreen mode

Dessa forma o Windows fará tudo automaticamente e você já pode pular para as dicas bônus acima.

Top comments (1)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.