#Что означает ошибка
WSL 2 installation is incomplete
Сообщение Docker Desktop «WSL 2 installation is incomplete» говорит, что компонент Windows Subsystem for Linux не установлен или не обновлён: нет ядра WSL, не включена виртуализация или не включены нужные компоненты Windows.
Проверка и исправление занимают несколько минут; потребуется перезагрузка.
Нужна Windows 10 версии 2004+ или Windows 11, виртуализация в BIOS (Intel VT-x, AMD-V/SVM).
Не установлен или не обновлён компонент WSL 2. Включите виртуализацию, установите ядро WSL и обновите его командой wsl --update.
#Причины и решения
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| WSL не установлен | wsl --status не находит установленный компонент или сообщает о необходимости установки. | Выполнить wsl --install на поддерживаемой Windows и перезагрузить ПК. |
| Аппаратная виртуализация отключена | В «Диспетчере задач» → «ЦП» указано «Виртуализация: Отключено». | Включить её по руководству производителя компьютера после сохранения работы. |
| WSL устарел | wsl --version (когда команда поддерживается) или сообщение Docker указывает на недостаточную версию. | Выполнить wsl --update и снова проверить версию. |
| Не включена Платформа виртуальной машины | WSL 2 не запускается с ошибкой о компонентах Windows; полный Hyper-V при этом необязателен. | Включить «Платформа виртуальной машины», перезагрузиться и проверить WSL. |
#Пошаговое решение
- Откройте PowerShell от администратораНа Windows нажмите Win+R, введите
winverи запишите выпуск и сборку системы. Затем откройте «Пуск», введитеPowerShell, нажмите правой кнопкой по «Windows PowerShell» или «Терминал» и выберите «Запуск от имени администратора», подтвердив запрос контроля учётных записей. Выполнитеwsl --statusиwsl --version(последняя команда отсутствует в некоторых старых выпусках). Если сообщается, что WSL не установлен, переходите к установке; если WSL есть, но версия старая, начните с обновления. Не выполняйте сразу все команды с советов из интернета. - Установите WSLЕсли Windows поддерживает WSL, но компонент ещё не установлен, в окне PowerShell с правами администратора выполните
wsl --install, дождитесь завершения установки и прочитайте подсказку о перезагрузке. Команда может дополнительно установить дистрибутив Linux, который Docker Desktop сам по себе не требует. Если указано, что компонент уже существует, повторно устанавливать его не нужно. На старой поддерживаемой сборке Windows может потребоваться ручное включение компонентов «Подсистема Windows для Linux» и «Платформа виртуальной машины» через Win+R →optionalfeatures, после чего перезагрузка; следуйте инструкции Microsoft для своей версии. - Обновите WSLЕсли
wsl --statusработает, но Docker требует новое ядро или WSL, запустите в административном PowerShellwsl --update. После завершения проверьтеwsl --version(когда команда доступна) иwsl -l -v. Если обновление недоступно из-за ограничений магазина или политики организации, не скачивайте неизвестные установщики: воспользуйтесь официальным вариантом обновления Microsoft или обратитесь к системному администратору. Не удаляйте дистрибутивы WSL командойwsl --unregister: это уничтожает их файловые системы. - Включите виртуализациюЕсли установка сообщает о недоступной виртуализации, нажмите Ctrl+Shift+Esc → «Производительность» → «ЦП» и найдите строку «Виртуализация». Если указано «Отключено», сохраните работу и обратитесь к инструкции производителя компьютера по включению Intel VT-x/AMD-V (SVM) в UEFI/BIOS; неверные изменения прошивки могут нарушить загрузку. Для WSL 2 нужна «Платформа виртуальной машины», но не требуется полный компонент Hyper-V: он доступен не во всех выпусках Windows. Если компьютер управляется организацией, запросите разрешение администратора.
- Диагностика в PowerShell; команда --version может отсутствовать в старых версиях WSLWindows · Командная строка (CMD)КомандаДиагностика в PowerShell; команда --version может отсутствовать в старых версиях WSL.
wsl --statuswsl --versionwsl -l -v - Перезагрузите ПК и запустите Docker DesktopПерезагрузите Windows после установки компонентов. Снова откройте PowerShell и проверьте
wsl --status,wsl -l -vи, если поддерживается,wsl --version. Отсутствие установленного пользовательского дистрибутива в списке не обязательно мешает Docker Desktop: у него есть собственная среда. Откройте Docker Desktop → Settings → General и, если переключатель отображается, включите «Use the WSL 2 based engine» → Apply & Restart. Затем в PowerShell выполнитеdocker version: должна быть видна секция Server. Если нет, откройте раздел Troubleshoot Docker и соберите диагностику, не применяя сброс с удалением данных.
#Установка и обновление WSL
При отсутствии WSL запустите wsl --install в PowerShell администратора; при установленном, но устаревшем WSL — wsl --update. Это альтернативные ситуации. После запрошенной перезагрузки проверьте wsl --status и wsl -l -v.
#Компоненты Windows
Если wsl --install не работает, включите компоненты вручную: dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart и dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart. Перезагрузитесь. Ядро WSL скачивается с .
#Виртуализация и конфликты
Для WSL 2 необходима включённая аппаратная виртуализация и компонент «Платформа виртуальной машины». Полный Hyper-V не обязателен. Не меняйте параметры загрузчика командой bcdedit как универсальное решение; сначала проверьте настройки по шагам и требования своей версии Windows.
# Только если WSL действительно не установлен:wsl --install# АЛЬТЕРНАТИВА при установленном WSL, которому нужно обновление:wsl --updateКоманда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.
#Как проверить результат
После перезагрузки выполните в PowerShell wsl -l -v: у дистрибутива должна быть версия 2 и состояние Running или Stopped. Затем запустите Docker Desktop и проверьте docker version и docker run --rm hello-world. Если Docker по-прежнему ругается, выполните wsl --shutdown и запустите Docker Desktop снова, а в «Settings → General» убедитесь, что включён пункт «Use the WSL 2 based engine». Подробности установки есть на странице .