Docker Desktop allows users to develop, manage, and share dockerized applications, but a few, when launching the app, received the Unexpected WSL error.
It could be encountered both on Windows and Mac, though we have seen more instances on the former. Most users who recently came across the error message, Docker Desktop – Unexpected WSL error, were running Windows 11.
What is WSL2 error in Docker Desktop?
WSL2 errors with Docker Desktop indicate either misconfigured permissions or the absence of critical components, especially the Virtual Machine Platform, an optional feature in Windows.
Also, if WSL itself is not installed, no WSL commands will be executed. And even network issues were reported to be an underlying cause by many.
How do I fix unexpected WSL error on Docker Desktop?
Before we delve into the slightly complex solutions, try these quick ones:
- Verify whether your device meets the minimum requirements for Docker Desktop.
- Restart the PC. If you have to reboot every time to get Docker Desktop running, try the other solutions.
- Check for available updates and install the latest version of Docker Desktop from the official website. Also, update the operating system. It helped many who came across the An unexpected error occurred. Restart Docker Desktop message.
- Make sure Docker Desktop is running with administrative privileges to eliminate any access rights issues. This also helps when Docker Desktop takes forever to start.
- Disable any third-party antivirus on the PC.
If none work, head to the fixes listed next.
1. Install WSL
- Press Windows + S to open Search, type Command Prompt in the search bar, and click Run as administrator.
- Click Yes in the UAC prompt.
- Now, paste the following command and hit Enter to install WSL:
wsl --install
- Once done, reboot the PC and check for improvements.
If Windows Subsystem for Linux is not installed, you will receive the Docker Desktop – Unexpected WSL error. After you do it, also enable Hyper-V on the device. It’s critical for Docker Desktop to run.
2. Update WSL
- Press Windows + R to open Run, type cmd, and hit Ctrl + Shift + Enter.
- Click Yes in the prompt that appears.
- Paste the following command and hit Enter to update WSL:
wsl --update
- If any updates are installed, restart the PC.
3. Modify the settings.json file
- Press Windows + E to open File Explorer, paste the following path in the address bar and hit Enter :
%Appdata%\Docker
- Double-click the settings.json file.
- Now, make sure it reads the following:
"integratedWslDistros": [ ]"enableIntegrationWithDefaultWslDistro": false
- If required, make the necessary edits and save the changes.
- После этого перезапустите проект, и он больше не должен выдавать ошибку «Не удалось запустить WSL2».
4. Измените настройки командной строки.
- Нажмите Windows + S, чтобы открыть поиск, введите Командная строка , щелкните правой кнопкой мыши соответствующий результат и выберите «Запуск от имени администратора».
- Нажмите Да в появившемся окне UAC.
- Теперь щелкните правой кнопкой мыши верхнюю панель и выберите Свойства в контекстном меню.
- Перейдите на вкладку «Параметры», установите флажок Использовать устаревшую консоль и нажмите «ОК», чтобы сохранить изменения.
5. Сбросить WinSock
- Нажмите Windows + R, чтобы открыть «Выполнить», введите cmd, удерживайте клавиши Ctrl + Shift и нажмите «ОК».
- Нажмите Да в командной строке.
- Теперь вставьте следующие две команды по отдельности и нажимайте Enter после каждой, чтобы сбросить поврежденные или неправильно настроенные сетевые настройки:
netsh int ip reset
netsh winsock reset
- Перезагрузите компьютер и проверьте, исчезла ли ошибка «Не удалось запустить Docker Desktop».
6. Включите аппаратную виртуализацию в BIOS.
- Выключите компьютер, затем включите его и, как только появится дисплей, продолжайте нажимать кнопки F2, F10, F12, Esc или Del для доступа к BIOS, в зависимости о производителе системы.
- Теперь с помощью клавиш со стрелками перейдите на вкладку Дополнительно или вкладку «Конфигурация системы», а затем выберите Технология виртуализации.
- Наконец, выберите Включить, затем сохраните изменения и выйдите из BIOS.
Очень важно включить поддержку виртуализации на ПК, чтобы Docker Desktop работал правильно. В противном случае вы можете получить сообщение об ошибке Docker Desktop — неожиданная ошибка WSL.
7. Переустановите WSL
- Нажмите Windows + I , чтобы открыть Настройки, перейдите в раздел «Приложения». на панели навигации и нажмите Установленные приложения справа.
- Теперь найдите Подсистему Windows для Linux, щелкните многоточие рядом с ней и выберите «Удалить».
- Еще раз нажмите Удалить в запросе подтверждения.
- Аналогичным образом удалите следующие записи в разделе установленных приложений, если они существуют:
- Линукс
- Убунту
- Теперь вернитесь на вкладку «Приложения» и выберите Дополнительные функции.
- Нажмите Дополнительные функции Windows внизу.
- Уберите флажок Платформа виртуальных машин и подсистема Windows для Linux, затем нажмите ОК, чтобы сохранить изменения.
- Перезагрузите компьютер, чтобы изменения вступили в силу.
- После этого переустановите WSL (подсистему Windows для Linux).
Если ничего не помогает, вы всегда можете переустановить WSL и избавиться от Docker Desktop — неожиданная ошибка WSL. Начните с удаления WSL, а затем повторно загрузите все компоненты.
Какова альтернатива Docker Desktop в Windows WSL?
Существует несколько альтернатив Docker Desktop, и многие пользователи перешли на них, учитывая недавние изменения условий лицензии проекта. Вот популярные варианты:
- Ранчер Рабочий стол
- Миникуб
- Подман
При переходе на другое программное обеспечение обязательно проверьте совместимость с вашей ОС, набор функций, производительность, простоту использования, эффективность службы поддержки и частоту выпуска обновлений.
К настоящему времени вы, должно быть, избавились от ошибки Docker Desktop – Unexpected WSL. А если это не так, либо дождитесь обновления, либо переключитесь на надежную альтернативу. Ты знаешь все варианты!
Кроме того, существуют и другие ошибки установки, которые влияют на пользователей. Например, многие сталкивались с ошибкой Hyper-V и функции контейнера Windows должны быть включены при установке Docker Desktop, но ее легко исправить!
Если у вас есть вопросы или вы хотите поделиться тем, что сработало для вас, оставьте комментарий ниже.
Добавить комментарий