Docker Desktop: Como corrigir erro "An error occurred while running the command. Wsl/Service/RegisterDistro/CreateVm/0x800705b4

Introdução

Ao utilizar o Docker Desktop em ambientes Windows Server com WSL 2 e virtualização aninhada, pode ocorrer uma falha durante a inicialização do Docker, impedindo a criação ou o registro da distribuição interna utilizada pelo Docker Desktop.

Esse comportamento foi identificado em cenários onde o Docker Desktop instala automaticamente uma versão mais recente do WSL. Em determinados ambientes com Windows Server e virtualização aninhada, essa versão pode apresentar incompatibilidade durante a criação da máquina virtual do WSL, resultando no erro Wsl/Service/RegisterDistro/CreateVm/0x800705b4.

Após validação técnica, a solução recomendada é instalar manualmente uma versão anterior do WSL, especificamente a versão 2.5.10, antes da instalação do Docker Desktop.

Erro apresentado

Ao abrir ou executar o Docker Desktop, o seguinte erro pode ser exibido:

There was a problem with WSL

An error occurred while running a WSL command. Please check your WSL
configuration and try again.

running wsl.exe: An error occurred while running the command.
Wsl/Service/RegisterDistro/CreateVm/0x800705b4:
c:\windows\system32\wsl.exe --import-in-place docker-desktop
<home>\appdata\local\docker\wsl\main\ext4.vhdx: exit status 0xffffffff
(stderr: wsl: Não há suporte para virtualização aninhada nesta máquina.
) stdout: Esta operação foi retornada porque o tempo limite expirou.
Código de erro: Wsl/Service/RegisterDistro/CreateVm/0x800705b4
, wslErrorCode: Wsl/Service/RegisterDistro/CreateVm/0x800705b4)

Na prática, o Docker Desktop não consegue inicializar corretamente o ambiente WSL utilizado internamente para executar os containers.

Ambiente afetado

Este procedimento se aplica principalmente a ambientes com as seguintes características:

Windows Server;
Docker Desktop;
WSL 2;
Virtualização aninhada habilitada;
Docker Desktop instalado diretamente, trazendo automaticamente uma versão mais recente do WSL.

Esse cenário costuma ocorrer em servidores virtualizados, onde o Windows Server está sendo executado dentro de uma VPS ou VM e depende de virtualização aninhada para que o WSL 2 funcione corretamente.

Causa identificada

O problema está relacionado à versão do WSL instalada no sistema.

Durante a instalação do Docker Desktop, uma versão mais recente do WSL pode ser instalada automaticamente. Em alguns ambientes Windows Server com virtualização aninhada, essa versão pode falhar durante a criação da VM utilizada pelo WSL, gerando o erro:

Wsl/Service/RegisterDistro/CreateVm/0x800705b4

A mensagem também pode indicar ausência de suporte à virtualização aninhada, mesmo quando ela já está habilitada no ambiente. Nesses casos, o problema pode estar associado à compatibilidade entre a versão do WSL, o Docker Desktop e o ambiente virtualizado.

Solução validada

A solução validada consiste em instalar manualmente uma versão anterior do WSL antes da instalação do Docker Desktop.

Versão recomendada:

WSL 2.5.10

Link oficial para download:

https://github.com/microsoft/WSL/releases/download/2.5.10/wsl.2.5.10.0.x64.msi

A ordem correta de instalação deve ser:

1. Instalar o WSL 2.5.10
2. Instalar o Docker Desktop

Procedimento para nova instalação

Caso o Docker Desktop ainda não tenha sido instalado no servidor, siga os passos abaixo.

1. Baixar e instalar o WSL 2.5.10

Baixe o instalador MSI do WSL 2.5.10 pelo link abaixo:

https://github.com/microsoft/WSL/releases/download/2.5.10/wsl.2.5.10.0.x64.msi

Após o download, execute o instalador no Windows Server e aguarde a conclusão da instalação.

2. Instalar o Docker Desktop

Depois de concluir a instalação do WSL 2.5.10, instale o Docker Desktop normalmente.

É importante que o WSL seja instalado antes do Docker Desktop. Dessa forma, o Docker utilizará a versão já instalada no ambiente, evitando que uma versão mais recente do WSL seja aplicada automaticamente durante o processo.

Procedimento para ambientes onde o Docker Desktop já foi instalado

Caso o Docker Desktop já tenha sido instalado anteriormente, é possível que uma versão mais recente do WSL tenha sido adicionada automaticamente ao sistema.

Nesse cenário, será necessário remover a versão atual do WSL antes de instalar a versão 2.5.10.

1. Abrir o PowerShell como administrador

Acesse o servidor Windows e abra o PowerShell com permissão de administrador.

2. Desinstalar a versão atual do WSL

Execute o comando abaixo:

wsl --uninstall

Aguarde a conclusão do processo de remoção.

3. Instalar o WSL 2.5.10

Após a remoção da versão atual, baixe e instale manualmente o WSL 2.5.10:

https://github.com/microsoft/WSL/releases/download/2.5.10/wsl.2.5.10.0.x64.msi

Execute o instalador no servidor e aguarde a finalização da instalação.

4. Reinstalar o Docker Desktop

Com o WSL 2.5.10 instalado, realize novamente a instalação do Docker Desktop.

Após a instalação, abra o Docker Desktop e verifique se a inicialização ocorre corretamente.

Validação

Após concluir o procedimento, valide se o WSL está instalado na versão esperada.

Abra o PowerShell e execute:

wsl --version

A saída esperada deve apresentar uma versão semelhante a:

WSL version: 2.5.10.0

Em seguida, abra o Docker Desktop e verifique se o serviço inicia normalmente, sem apresentar o erro relacionado ao WSL.

Observações importantes

O WSL deve ser instalado antes do Docker Desktop.
Caso o Docker Desktop tenha instalado automaticamente uma versão mais recente do WSL, remova a versão atual antes de aplicar este procedimento.
Este procedimento é recomendado especificamente para ambientes Windows Server com virtualização aninhada.
Evite atualizar o WSL após a correção, até que uma versão mais recente seja validada para esse cenário.
Antes de aplicar o procedimento em ambiente de produção, recomenda-se validar o impacto da remoção do WSL, principalmente se existirem distribuições Linux ou aplicações dependentes do WSL no servidor.

Conclusão

O erro Wsl/Service/RegisterDistro/CreateVm/0x800705b4 no Docker Desktop pode ocorrer em ambientes Windows Server com WSL 2 e virtualização aninhada, especialmente quando uma versão mais recente do WSL é instalada automaticamente junto ao Docker Desktop.

Para corrigir o problema, a solução validada é instalar manualmente o WSL 2.5.10 antes da instalação do Docker Desktop. Em ambientes onde o Docker Desktop já foi instalado, recomenda-se remover a versão atual do WSL, instalar a versão 2.5.10 e, em seguida, reinstalar o Docker Desktop.

Com esse procedimento, o Docker Desktop tende a inicializar corretamente, evitando a falha na criação da VM interna do WSL.