Mudanças entre as edições de "Instruções para instalação do WSL no windows"

Edição atual tal como às 09h46min de 17 de abril de 2025

Este procedimento tem como objetivo orientar a instalação e configuração do WSL (Windows Subsystem for Linux) em sistemas Windows. Para utilizar o WSL, é necessário seguir alguns passos iniciais.

Habilitando os recursos necessários do Windows

Primeiro, pesquise por Ativar ou desativar recursos do Windows no menu iniciar 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.

Instalando e configurando o WSL e o Ubuntu

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

Atualizar o WSL

Abra o PowerShell 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.

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.

Configurar recursos do WSL (ajustes de performance)

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

Ainda no PowerShell execute os comandos abaixo :

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.

Definir usuário padrão como root

Agora que o Ubuntu foi baixado corretamente, execute o comando abaixo para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL.

ubuntu config --default-user root

Isso evita a criação de usuário e senha na primeira inicialização, e é útil para ambientes de teste e desenvolvimento.

Reiniciar o WSL

Após todas as configurações, reinicie o WSL com o comando:

wsl --shutdown

Isso aplica as alterações realizadas no arquivo `.wslconfig`.

Tornar o disco virtual do WSL dinâmico (sparse)

Por padrão, o WSL mantém o tamanho do disco virtual fixo. Com a opção sparse, o espaço em disco é liberado automaticamente quando arquivos são removidos.

Execute o seguinte comando no PowerShell:

wsl --manage Ubuntu --set-sparse true

Esse comando permite que o disco virtual da distribuição Ubuntu use alocação dinâmica de espaço.

Acessando o WSL

Para abrir o WSL, basta pesquisar por WSL no menu Iniciar do Windows e abrir o aplicativo mostrado abaixo.

Abrindo o WSL através da pesquisa do Windows

Isso abrirá um terminal do Ubuntu.

Definindo o Usuário e a Senha

Na primeira vez que você acessar o WSL, pode ser solicitado para criar um usuário UNIX e definir uma senha. O nome do usuário será sugerido automaticamente com base no nome de usuário do Windows, mas você pode alterá-lo, caso deseje.

Depois de inserir e confirmar a senha, o Ubuntu será inicializado e você poderá começar a usar o terminal para executar comandos Linux.

Utilizando o Terminal do WSL

Para garantir que o WSL funcione corretamente com o Docker e ofereça suporte a permissões de arquivos do Windows, é necessário criar o arquivo de configuração /etc/wsl.conf com as opções abaixo:

{
    echo "[automount]";
    echo "options = \"metadata\"";
    echo "[boot]";
    echo "command=\"service docker start\"";
} > /etc/wsl.conf

Esse comando permite editar arquivos do sistema, como o /etc/wsl.conf.

Observação: caso o usuário não esteja com permissões de superusuário (root) e ao executar o comando ocorra a mensagem permission denied, será necessário obter privilégios de root. Para isso, utilize o comando:

 sudo su

Após essa configuração, atualize a lista de pacotes do sistema com o seguinte comando:

 apt-get update -y

Esse comando atualiza os índices de pacotes disponíveis para instalação, garantindo que você tenha acesso às versões mais recentes dos softwares disponíveis nos repositórios do Ubuntu.

@@ Linha 1: / Linha 1: @@
-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 de forma integrada.
+Este procedimento tem como objetivo orientar a instalação e configuração do '''WSL (Windows Subsystem for Linux)''' em sistemas Windows.
+Para utilizar o '''WSL''', é necessário seguir alguns passos iniciais.
+== Habilitando os recursos necessários do Windows ==
+Primeiro, pesquise por '''Ativar ou desativar recursos do Windows''' no menu iniciar 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.
-== 1 - Habilitar recursos do Windows ==
+[[File:ClipCapIt-250416-132133.PNG|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
-Na janela de Ativar ou desativar recursos marque as seguintes opções:
+* Subsistema do Windows para Linux
-*'''Hyper-V'''
+Após marcar as opções, clique em '''OK''' e aguarde enquanto o sistema aplica as alterações.
-* '''Plataforma de Máquina Virtual'''
+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.
+==  Instalando e configurando o WSL e o Ubuntu ==
-* '''Plataforma do Hipervisor do Windows'''
+Após reiniciar o computador, siga os passos abaixo para instalar o WSL, a distribuição Ubuntu e aplicar algumas configurações de performance.
-* '''Subsistema do Windows para Linux'''
+=== Atualizar o WSL ===
-[[File:ClipCapIt-250416-132133.PNG|center|Recursos que devem ser ativados para uso do WSL]]
+Abra o '''PowerShell''' e execute:
-Após marcar as opções, clique em '''OK''' e aguarde enquanto o sistema aplica as alterações.
+<syntaxhighlight lang="powershell">
+wsl --update
+</syntaxhighlight>
+Esse comando garante que você está utilizando a versão mais recente do WSL disponível no sistema.
-Ao terminar a instalação dos recursos, será solicitada a reinicialização do sistema.
+Em seguida, execute:
-Reinicie o computador para que os recursos sejam devidamente ativados e o ambiente esteja pronto para a instalação do WSL.
 <syntaxhighlight lang="powershell">
@@ Linha 27: / Linha 43: @@
 </syntaxhighlight>
-Ou, se preferir, utilize:
+ou
 <syntaxhighlight lang="powershell">
@@ Linha 33: / Linha 49: @@
 </syntaxhighlight>
-Certifique-se de que a versão do WSL instalada é a '''versão 2.'''
+Esses comandos exibem informações sobre a versão do WSL instalada. Verifique se a versão exibida corresponde ao '''WSL 2'''.
-Caso o WSL ainda não esteja instalado, você pode instalá-lo com o comando abaixo:
+=== Instalar a distribuição Ubuntu ===
+Para instalar a distribuição Ubuntu, execute:
 <syntaxhighlight lang="powershell">
@@ Linha 41: / Linha 58: @@
 </syntaxhighlight>
-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.
+Aguarde até a conclusão da instalação. A primeira inicialização pode demorar alguns minutos.
-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.
+=== Configurar recursos do WSL (ajustes de performance) ===
+Você pode limitar a quantidade de memória e núcleos que o WSL utilizará, além de ativar funcionalidades experimentais.
-== 4 - Configurar recursos do WSL 2 via PowerShell ==
+Ainda no PowerShell execute os comandos abaixo :
-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`:
 <syntaxhighlight lang="powershell">
@@ Linha 62: / Linha 74: @@
 </syntaxhighlight>
-Essas linhas irão criar (ou complementar, caso o arquivo já exista) o seguinte conteúdo no arquivo `.wslconfig`:
+Essas configurações serão salvas no arquivo:
+<code>C:\Users\SEU_USUÁRIO\.wslconfig</code>
+Você pode editar esse arquivo manualmente no futuro, se quiser ajustar os recursos.
+=== Definir usuário padrão como root ===
-<syntaxhighlight lang="ini">
+Agora que o Ubuntu foi baixado corretamente, execute o comando abaixo para que o usuário root seja o padrão ao iniciar o Ubuntu no WSL.
-[wsl2]
-memory=8GB
-processors=3
-[experimental]
+<syntaxhighlight lang="powershell">
-autoMemoryReclaim=dropcache
+ubuntu config --default-user root
 </syntaxhighlight>
-Essa configuração define que:
+Isso evita a criação de usuário e senha na primeira inicialização, e é útil para ambientes de teste e desenvolvimento.
-- O WSL 2 poderá usar até **8 GB de RAM**.
+=== Reiniciar o WSL ===
-- 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:
+Após todas as configurações, reinicie o WSL com o comando:
 <syntaxhighlight lang="powershell">
@@ Linha 85: / Linha 98: @@
 </syntaxhighlight>
-Depois disso, ao abrir novamente a distribuição Ubuntu, as novas configurações já estarão aplicadas.
+Isso aplica as alterações realizadas no arquivo `.wslconfig`.
+=== Tornar o disco virtual do WSL dinâmico (sparse) ===
+Por padrão, o WSL mantém o tamanho do disco virtual fixo. Com a opção '''sparse''', o espaço em disco é liberado automaticamente quando arquivos são removidos.
+Execute o seguinte comando no PowerShell:
+<syntaxhighlight lang="powershell">
+wsl --manage Ubuntu --set-sparse true
+</syntaxhighlight>
+Esse comando permite que o disco virtual da distribuição Ubuntu use alocação dinâmica de espaço.
+== Acessando o WSL ==
+Para abrir o WSL, basta pesquisar por WSL no menu Iniciar do Windows e abrir o aplicativo mostrado abaixo.
+[[File:ClipCapIt-250416-161543.PNG|center|Abrindo o WSL através da pesquisa do Windows]]
+Isso abrirá um terminal do Ubuntu.
+=== Definindo o Usuário e a Senha ===
+Na primeira vez que você acessar o WSL, pode ser solicitado para criar um '''usuário UNIX''' e definir uma '''senha'''. O nome do usuário será sugerido automaticamente com base no nome de usuário do Windows, mas você pode alterá-lo, caso deseje.
+Depois de inserir e confirmar a senha, o Ubuntu será inicializado e você poderá começar a usar o terminal para executar comandos Linux.
+=== Utilizando o Terminal do WSL ===
+Para garantir que o WSL funcione corretamente com o Docker e ofereça suporte a permissões de arquivos do Windows, é necessário criar o arquivo de configuração '''/etc/wsl.conf''' com as opções abaixo:
+<syntaxhighlight lang="bash">
+{
+    echo "[automount]";
+    echo "options = \"metadata\"";
+    echo "[boot]";
+    echo "command=\"service docker start\"";
+} > /etc/wsl.conf
+</syntaxhighlight>
+Esse comando permite editar arquivos do sistema, como o /etc/wsl.conf.
+Observação: caso o usuário não esteja com permissões de superusuário (root) e ao executar o comando ocorra a mensagem permission denied, será necessário obter privilégios de root. Para isso, utilize o comando:
+<syntaxhighlight lang="bash"> sudo su </syntaxhighlight>
+Após essa configuração, atualize a lista de pacotes do sistema com o seguinte comando:
+<syntaxhighlight lang="bash"> apt-get update -y </syntaxhighlight>
+Esse comando atualiza os índices de pacotes disponíveis para instalação, garantindo que você tenha acesso às versões mais recentes dos softwares disponíveis nos repositórios do Ubuntu.