A migração do Windows Subsystem for Linux (WSL) para outro disco ou computador pode parecer uma tarefa desafiadora, mas com as orientações corretas, você pode migrar o WSL sem complicações.
O WSL (Windows Subsystem for Linux) é um recurso do Windows que permite rodar distribuições Linux, como Ubuntu e Kali, de forma integrada ao sistema. Com ele, você pode executar aplicações Linux, como Apache, MySQL e PHP, além de ferramentas de cibersegurança, no caso do Kali Linux.
Se você ainda não conhecia o WSL, já temos vários vídeos no canal ensinando desde a instalação até como usar XAMPP e Oh My Zsh dentro do WSL.
Neste artigo, abordaremos um guia passo a passo sobre como migrar suas instâncias WSL para um novo local, seja em um disco diferente ou em um novo computador.
Vamos explorar a importância dessa migração, especialmente para desenvolvedores e usuários que precisam de acesso contínuo aos seus ambientes de desenvolvimento.
Se você está se perguntando por que deveria migrar seu WSL, considere os benefícios: mais espaço de armazenamento, melhor desempenho ou a necessidade de mudar para um novo hardware.
Vídeo Aula : Como Migrar o Windows WSL para outro Disco ou Computador
Introdução
Pouca gente sabe, mas é possível mover o WSL para outro disco no mesmo PC ou até mesmo para outro computador.
Neste guia, vamos mostrar o passo a passo para migrar a instalação do WSL para a unidade D:\wsl\
.
O processo envolve exportar a distribuição existente, desinstalá-la e depois importá-la para o novo local.

Passos para Mover o WSL para Outro Disco
- Abrir o PowerShell como Administrador
Pressione Win + X e selecione Windows Terminal (Admin) ou PowerShell (Admin).
Preparando o Ambiente
Antes de iniciar a migração, é crucial preparar seu ambiente WSL. Isso inclui:
- Verificar a versão do WSL instalada.
- Realizar backup de seus dados importantes.
- Certificar-se de que você tem acesso ao novo disco ou computador.
Listar as distribuições instaladas
Para verificar a versão do WSL, abra o PowerShell e digite:
wsl --list --verbose
Isso mostrará as distribuições instaladas e suas versões.
Anote as informações da distribuição que deseja migrar.
Exportando suas Instâncias WSL
O primeiro passo na migração é exportar suas instâncias WSL.
Isso pode ser feito facilmente usando o comando wsl --export
.
Substitua <distro> pelo nome da distribuição anotado anteriormente:
wsl --shutdown
wsl --export <distro> D:\wsl\<distro>.tar
Por exemplo, se você tiver uma distribuição chamada Ubuntu22.04, o comando seria:
wsl --export Ubuntu-22.04 D:\wsl\ubuntu-22.04.tar
Isso criará um backup da distribuição no novo disco.
Após executar este comando, você terá um arquivo TAR contendo todos os dados da sua distribuição WSL.
Desinstalar a distribuição existente
wsl --unregister <distro>
A distribuição será removida do WSL, mas o backup no arquivo .tar será mantido.
Transferindo o Arquivo para o Novo Local
Depois de exportar sua instância, o próximo passo é transferir o arquivo TAR para o novo disco ou computador. Você pode usar um pen drive, armazenamento em nuvem ou qualquer outro meio de transferência que preferir. Certifique-se de que o arquivo está acessível no novo local onde você deseja restaurar sua instância.
Importar a distribuição para o novo local
wsl --import <distro> D:\wsl D:\wsl\<distro>.tar
Definir a nova distribuição como padrão (opcional)
wsl --set-default <distro>
Acessar normalmente o WSL
wsl
ou
wsl -d <distro>
Como Migrar o WSL para Outro Computador
O processo é semelhante. Vamos detalhar as etapas para mover o WSL de um PC para outro.
No PC Antigo
Fechar o WSL
wsl --shutdown
Exportar a distribuição para um arquivo .tar
wsl --export Ubuntu-22.04 D:\wsl\ubuntu-22.04.tar
Copiar o arquivo .tar
para o novo PC
Use um pendrive, HD externo ou rede para transferir ubuntu-22.04.tar
.
No Novo PC
Instalar o WSL (se ainda não tiver)
No PowerShell (Admin):
wsl --install
Reinicie o PC, se necessário.
Importar a distribuição para o novo PC
wsl --import Ubuntu-22.04 D:\wsl D:\wsl\ubuntu-22.04.tar
Definir a distribuição como padrão (opcional)
wsl --set-default Ubuntu-22.04
Abrir o WSL normalmente
wsl
ouwsl -d Ubuntu-22.04
Observações Importantes : Migrar o WSL outro Computador
- Os arquivos pessoais do WSL serão mantidos na distribuição exportada.
- Configurações do WSL (versão 1 ou 2) podem precisar ser ajustadas no novo PC:
wsl --set-version Ubuntu-22.04 2
- Acessando arquivos do Linux pelo Explorer:
\\wsl$\Ubuntu-22.04\
- Serviços configurados (Apache, MySQL, etc.) podem precisar ser reconfigurados.
Considerações Finais
- O caminho
D:\wsl
pode ser alterado conforme sua preferência. - Se estiver usando WSL2, os arquivos são armazenados como um VHDX (disco virtual), garantindo um funcionamento correto.
- Se houver problemas de permissão, verifique as configurações de acesso da pasta
l.D:\ws
- Após a importação, o arquivo
.tar
pode ser apagado para liberar espaço. - Sempre execute o PowerShell como administrador para evitar erros.
Com esses passos, sua distribuição Ubuntu-22.04
estará rodando no WSL 2 em outro disco ou computador.