This update only applies to machines with the windows subsystem for linux
How to update the WSL2 kernel on current Windows 10 #5650
Comments
angelog0 commented Jul 25, 2020
I am on current Windows 10 19041.388 and I would to know how WSL2 kernel updates. I see that Settings Apps has WSL Update package.
Will it occur with Windows Update, and I have only to wait? or is there another way?
The text was updated successfully, but these errors were encountered:
koraylinux commented Jul 25, 2020 •
Before installing WSL 2, you must enable the «Virtual Machine Platform» optional feature.
Open PowerShell as Administrator and run:
Open PowerShell as Administrator and run this command to set WSL 2 as the default version when installing a new Linux distribution:
You might see this message after running that command:
Please follow the link (https://aka.ms/wsl2kernel) and install the MSI from that page on our documentation to install a Linux kernel on your machine for WSL 2 to use. Once you have the kernel installed, please run the command again and it should complete successfully without showing the message.
My note: After completed these steps don’t forget to set your distribution version to WSL 2. You don’t need to reinstall the ubuntu. I used this command:
angelog0 commented Jul 25, 2020
koraylinux commented Jul 25, 2020
Could you share the link where you seen the discussion about new kernel?
angelog0 commented Jul 25, 2020
AleCx4 commented Jul 26, 2020
Guess we are going to have to wait for the actual update to appear on the system for itself?
therealkenc commented Jul 28, 2020 •
Current (see above) not insider or other development version of Windows.
#5642, for example.
That issue didn’t state build number, but did state right at the top «Windows Insider Program with Dev Channel».
On 2004 aka 19041 the kernel is installed via https://aka.ms/wsl2kernel. Whether that msi package gets updated to a new kernel absent some (hard to imagine) critical bug in the kernel seems unlikely. [But I wouldn’t want to jinx that with a «never».]
That CUDA is not available in Win10 2004 goes without saying.
korypostma commented Nov 1, 2020
As of 2020-10-31 the msi installs 4.19.128-microsoft-standard
PavelSosin-320 commented Nov 23, 2020
matheussouza9 commented Nov 24, 2020
According to Windows Command Line Blog, WSL2 kernel updates will be available through Windows Update.
I got an update, a month ago, to the 4.19.128 version, but there is a new stable kernel release, 5.4.51. Unfortunately, this new version isn’t available yet through Windows Update (I don’t know why).
Biswa96 commented Nov 24, 2020
PavelSosin-320 commented Nov 26, 2020
DoctorWho8 commented Nov 26, 2020
PavelSosin-320 commented Nov 27, 2020
@DoctorWho8 Unfortunately 
, it does nothing
PavelSosin-320 commented Dec 3, 2020
cpoptic commented Dec 6, 2020
@PavelSosin-320 +1 I too am encountering this issue.
cpoptic commented Dec 6, 2020 •
I have absolutely no idea how to fix this.
Why can the older version not be removed.
These are the four distributions I have installed:
PavelSosin-320 commented Dec 8, 2020 •
angelog0 commented Dec 8, 2020 •
DoctorWho8 commented Dec 8, 2020
Well perhaps the fact that this OS isn’t part of the Insider collection might be part of the difference. Anyway I was successful following the steps I outlined above.
CaseyLabs commented Jan 23, 2021
For users coming here from a Google search for WSL2 Kernel Upgrade:
Open and extract the update to your desktop
Run these commands in the command prompt:
This should update the kernel and show you the latest running version.
cpoptic commented Jan 23, 2021 •
@CaseyLabs I’ve tried this many times but it’s blocked at:
The file wsl_update_x64.msi is not a valid installation package for the product Windows Subsystem for Linux Update. Try to find the installation package ‘wsl_update_x64.msi’ in a folder from which you can install Windows Subsystem for Linux Update.
Regardless of where I browse in my File Explorer and point to the downloaded wsl_update_x64.msi installer package, it continues to give this same response. Blocked. 
DoctorWho8 commented Jan 23, 2021
Right click on it and bring up the properties dialog box. Check to see if it shows that the blocked checkbox is checked. Uncheck it and close the dialog box. Then try again.
fox4u commented Feb 4, 2021
Turn «Receive updates for other Microsoft products when you update Windows» on in Advance options of Windows update, the WSL2 kernel will get updated automatically.
angelog0 commented Feb 7, 2021
Turn «Receive updates for other Microsoft products when you update Windows» on in Advance options of Windows update, the WSL2 kernel will get updated automatically.
This seems to fix the issue. After enabling that, it updated the kernel which now is 5.4.72!
Biswa96 commented Feb 7, 2021
In Microsoft Catalog, the update is now 5.4.91.
fenris commented Feb 19, 2021
TBBle commented Mar 1, 2021
The latest WSL 2 kernel for 20H2 19042.804 is 5.4.72.
Even if you install 5.4.91 from the Microsoft Catalog by hand, Windows Update (with «Receive updates for other Microsoft products when you update Windows» enabled) will attempt to downgrade you back to 5.4.72, which fails unless you uninstall the 5.4.91 kernel from Add/Remove Programs first. Apart from that, the hand-upgraded kernel seemed to work, but I didn’t really put it through its paces.
So it seems to be working-as-intended.
@fenris What did you have in mind as an update?
I expect that Windows Insiders get Linux 5.4.91 installed by WU, but don’t know for sure. The Microsoft Catalog web UI doesn’t tell you which Windows builds will get which updates, so I’m not sure if there’s a way to confirm this, and I don’t have an Insider build running.
ev-dev commented Apr 10, 2021
@TBBle I was also having this issue until I did:
ev-dev commented Apr 10, 2021
I want to try more recent kernal versions like the 5.5.3 branch from https://github.com/microsoft/WSL2-Linux-Kernel/tree/v5.5.3 which seems to be latest release build. No prebuilt msi installer is available for these but maybe source build & kernal patch is feasible? Anyone try this?
netcore-jroger commented Apr 10, 2021
For users coming here from a Google search for WSL2 Kernel Upgrade:
This should update the kernel and show you the latest running version.
ev-dev commented Apr 10, 2021
Yes @netcore-jroger this what I followed as well, but it did not work for me.
The only piece I added was the manual «Repair» step in control panel programs manager. That triggered a blank system progress bar to show and I believe some kind of install fix which only after let me validate the latest version was active (perhaps a registry tweak or something else that wasn’t being set right during install? apologies, not very savy about windows internals)
Regardless, the manual «Repair» of the install is certainly something else to try if you’re having problems getting a newer kernel to install & persist
netcore-jroger commented Apr 11, 2021
Yes @netcore-jroger this what I followed as well, but it did not work for me.
The only piece I added was the manual «Repair» step in control panel programs manager. That triggered a blank system progress bar to show and I believe some kind of install fix which only after let me validate the latest version was active (perhaps a registry tweak or something else that wasn’t being set right during install? apologies, not very savy about windows internals)
Regardless, the manual «Repair» of the install is certainly something else to try if you’re having problems getting a newer kernel to install & persist
I used that method. Solved my problem. May be the system version is different.
Руководство по установке подсистемы Windows для Linux в Windows 10 Windows Subsystem for Linux Installation Guide for Windows 10
Возможны два варианта установки подсистемы Windows для Linux (WSL): There are two options available for installing Windows Subsystem for Linux (WSL):
Установка вручную : выполните приведенные ниже шаги. Manual install: Follow the six steps listed below.
Ниже указаны шаги по установке WSL вручную, которые также можно использовать для установки Linux в любой версии Windows 10. The manual install steps for WSL are listed below and can be used to install Linux on any version of Windows 10.
Если во время установки возникла проблема, обратитесь к разделу Устранение неполадок установки в нижней части этой страницы. If you run into an issue during the install process, check the Troubleshooting installation section at the bottom of this page.
Упрощенная установка для участников программы предварительной оценки Windows Simplified Installation for Windows Insiders
Процесс установки подсистемы Windows для Linux был значительно улучшен в последних предварительных сборках Windows 10 для участников программы предварительной оценки Windows — приведенные ниже шаги, которые выполняются вручную, были заменены одной командой. The installation process for Windows Subsystem for Linux has been significantly improved in the latest Windows Insiders preview builds of Windows 10, replacing the manual steps below with a single command.
Если эти требования выполнены, выполните следующие действия, чтобы установить WSL: Once those requirements are met, to install WSL:
При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать, чтобы файлы распаковались и сохранились на компьютере. The first time you launch a newly installed Linux distribution, a console window will open and you’ll be asked to wait for files to de-compress and be stored on your PC. Все будущие запуски должны занимать меньше секунды. All future launches should take less than a second.
Поздравляем! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows. CONGRATULATIONS! You’ve successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!
Шаги по установке вручную Manual Installation Steps
Если вы не используете сборку для участников программы предварительной оценки Windows, компоненты, необходимые для WSL, потребуется включить вручную. Для этого выполните приведенные ниже шаги. If you are not on a Windows Insiders build, the features required for WSL will need to be enabled manually following the steps below.
Перед установкой дистрибутивов Linux в Windows необходимо включить дополнительный компонент «Подсистема Windows для Linux». You must first enable the «Windows Subsystem for Linux» optional feature before installing any Linux distributions on Windows.
Запустите PowerShell с правами администратора и выполните следующую команду. Open PowerShell as Administrator and run:
Для обновления до WSL 2 требуется Windows 10. To update to WSL 2, you must be running Windows 10.
Чтобы проверить версию и номер сборки, нажмите клавиши Windows+R, введите winver и нажмите кнопку ОК. To check your version and build number, select Windows logo key + R, type winver, select OK. (Или введите команду ver в командной строке Windows). (Or enter the ver command in Windows Command Prompt). В меню «Параметры» выполните обновление до последней версии Windows. Update to the latest Windows version in the Settings menu.
Перед установкой WSL 2 необходимо включить необязательный компонент Платформа виртуальных машин. Before installing WSL 2, you must enable the Virtual Machine Platform optional feature. Для использования этой функции на компьютере потребуются возможности виртуализации. Your machine will require virtualization capabilities to use this feature.
Запустите PowerShell с правами администратора и выполните следующую команду. Open PowerShell as Administrator and run:
Перезапустите компьютер, чтобы завершить установку и обновление WSL до WSL 2. Restart your machine to complete the WSL install and update to WSL 2.
Скачайте пакет последней версии: Download the latest package:
Откройте PowerShell и выполните следующую команду, чтобы задать WSL 2 в качестве версии по умолчанию при установке нового дистрибутива Linux: Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:
Откройте Microsoft Store и выберите предпочтительный дистрибутив Linux. Open the Microsoft Store and select your favorite Linux distribution.
Ниже приведены ссылки на страницы Microsoft Store для каждого дистрибутива: The following links will open the Microsoft store page for each distribution:
На странице дистрибутива щелкните «Получить». From the distribution’s page, select «Get».
При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать минуту или две, чтобы файлы распаковались и сохранились на компьютере. The first time you launch a newly installed Linux distribution, a console window will open and you’ll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Все будущие запуски должны занимать меньше секунды. All future launches should take less than a second.
Поздравляем! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows. CONGRATULATIONS! You’ve successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!
Установка Терминала Windows (необязательно) Install Windows Terminal (optional)
В Терминале Windows можно использовать несколько вкладок (чтобы быстро переходить между несколькими командными строками Linux, командной строкой Windows, PowerShell, Azure CLI и пр.), создавать пользовательские сочетания клавиш (для открытия и закрытия вкладок, копирования и вставки и пр.), а также применять функцию поиска и пользовательские темы (цветовые схемы, стили и размеры шрифтов, а также фоновое изображение, размытие и прозрачность). Windows Terminal enables multiple tabs (quickly switch between multiple Linux command lines, Windows Command Prompt, PowerShell, Azure CLI, etc), create custom key bindings (shortcut keys for opening or closing tabs, copy+paste, etc.), use the search feature, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). Подробнее. Learn more.
Установите вашу версию дистрибутива на WSL 1 или WSL 2 Set your distribution version to WSL 1 or WSL 2
Чтобы настроить дистрибутив для одной из версий WSL, выполните: To set a distribution to be backed by either version of WSL please run:
Не забудьте заменить на фактическое имя дистрибутива и с номером «1» или «2». Make sure to replace with the actual name of your distribution and with the number ‘1’ or ‘2’. Вы можете всегда вернуться к WSL версии 1, выполнив эту команду и заменив «2» на «1». You can change back to WSL 1 at anytime by running the same command as above but replacing the ‘2’ with a ‘1’.
Обновление с WSL 1 до WSL 2 может занять несколько минут в зависимости от размера целевого дистрибутива. The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Если вы используете устаревшую установку WSL 1 из Юбилейного обновления Windows 10 или обновления Creators Update, может возникнуть ошибка обновления. If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Выполните эти инструкции, чтобы удалить устаревшие дистрибутивы. Follow these instructions to uninstall and remove any legacy distributions.
Кроме того, если вы хотите сделать WSL 2 архитектурой по умолчанию, выполните следующую команду: Additionally, if you want to make WSL 2 your default architecture you can do so with this command:
Будет установлена версия любого нового дистрибутива, установленного в WSL 2. This will set the version of any new distribution installed to WSL 2.
Устранение неполадок установки Troubleshooting installation
Ниже перечислены возможные ошибки и способы их устранения. Below are related errors and suggested fixes. Другие распространенные ошибки и способы их устранения приведены в разделе Устранение неполадок подсистемы Windows для Linux. Refer to the WSL troubleshooting page for other common errors and their solutions.
Сбой установки с ошибкой 0x80070003 Installation failed with error 0x80070003
Сбой WslRegisterDistribution с ошибкой 0x8007019e WslRegisterDistribution failed with error 0x8007019e
Сбой установки с ошибкой 0x80070003 или ошибкой 0x80370102. Installation failed with error 0x80070003 or error 0x80370102
Запрошенную операцию не удалось выполнить из-за ограничения системы виртуального диска. Файлы виртуального жесткого диска должны быть распакованными, незашифрованными и не разреженными. The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.
В этом примере папка LocalState для дистрибутива Ubuntu 18.04 расположена по адресу C:\Users \AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc In my case, the LocalState folder for my Ubuntu 18.04 distribution was located at C:\Users \AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc
Чтобы получать обновленные сведения, проверьте ветку № 4103 в документации GitHub WSL, где отслеживается эта проблема. Check WSL Docs GitHub thread #4103 where this issue is being tracked for updated information.
Термин WSL не распознан как имя командлета, функции, файла скрипта или действующей программы. The term ‘wsl’ is not recognized as the name of a cmdlet, function, script file, or operable program.
Error: This update only applies to machines with the Windows Subsystem for Linux (Ошибка. Это обновление применяется только к компьютерам с подсистемой Windows для Linux). Error: This update only applies to machines with the Windows Subsystem for Linux.
Вы используете старую версию Windows, которая не поддерживает WSL 2. You are still in old version of Windows which doesn’t support WSL 2. Требования к версиям и ссылки пакеты обновления см. на шаге 2. See step #2 for version requirements and links to update.
Компонент WSL не включен. WSL is not enabled. Необходимо вернуться к шагу 1 и убедиться, что на компьютере включен необязательный компонент WSL. You will need to return to step #1 and ensure that the optional WSL feature is enabled on your machine.
Когда он будет включен, перезагрузите компьютер, чтобы изменения вступили в силу, и повторите попытку. After you enabled WSL, a reboot is required for it to take effect, reboot your machine and try again.
This update only applies to machines with the windows subsystem for linux
Руководство по установке подсистемы Windows для Linux в Windows 10
Возможны два варианта установки подсистемы Windows для Linux (WSL):
Установка вручную : выполните приведенные ниже шаги.
Ниже указаны шаги по установке WSL вручную, которые также можно использовать для установки Linux в любой версии Windows 10.
[!NOTE] Если во время установки возникла проблема, обратитесь к разделу Устранение неполадок установки в нижней части этой страницы.
Упрощенная установка для участников программы предварительной оценки Windows
Процесс установки подсистемы Windows для Linux был значительно улучшен в последних предварительных сборках Windows 10 для участников программы предварительной оценки Windows — приведенные ниже шаги, которые выполняются вручную, были заменены одной командой.
Если эти требования выполнены, выполните следующие действия, чтобы установить WSL:
При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать, чтобы файлы распаковались и сохранились на компьютере. Все будущие запуски должны занимать меньше секунды.
Поздравляем! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows.
Шаги по установке вручную
Если вы не используете сборку для участников программы предварительной оценки Windows, компоненты, необходимые для WSL, потребуется включить вручную. Для этого выполните приведенные ниже шаги.
Шаг 1. Включение подсистемы Windows для Linux
Перед установкой дистрибутивов Linux в Windows необходимо включить дополнительный компонент «Подсистема Windows для Linux».
Запустите PowerShell с правами администратора и выполните следующую команду.
Теперь перейдите к шагу 2 и выполните обновление до WSL 2. Если вы хотите установить только WSL 1, вы можете перезагрузить компьютер и перейти к разделу Шаг 6. Установка дистрибутива Linux по выбору. Чтобы выполнить обновление до WSL 2, дождитесь перезагрузки компьютера и перейдите к следующему шагу.
Шаг 2. Проверка требований для запуска WSL 2
Для обновления до WSL 2 требуется Windows 10.
Чтобы проверить версию и номер сборки, нажмите клавиши Windows+R, введите winver и нажмите кнопку ОК. (Или введите команду ver в командной строке Windows). В меню «Параметры» выполните обновление до последней версии Windows.
[!NOTE] Если вы используете Windows 10 версии 1903 или 1909, в меню Windows откройте меню «Параметры», перейдите к разделу «Обновления и безопасность» и выберите «Проверить наличие обновлений». Номер сборки должен быть 18362.1049 и выше или 18363.1049 и выше с номером дополнительной сборки не ниже 1049. Подробнее: поддержка WSL 2 вскоре будет реализована в Windows 10 версий 1903 и 1909. См. инструкции по устранению неполадок.
Шаг 3. Включение компонента виртуальных машин
Перед установкой WSL 2 необходимо включить необязательный компонент Платформа виртуальных машин. Для использования этой функции на компьютере потребуются возможности виртуализации.
Запустите PowerShell с правами администратора и выполните следующую команду.
Перезапустите компьютер, чтобы завершить установку и обновление WSL до WSL 2.
Шаг 4. Скачивание пакета обновления ядра Linux
Скачайте пакет последней версии:
Запустите пакет обновления, скачанный на предыдущем этапе. (Для запуска щелкните дважды. Появится запрос на повышение уровня разрешений. Нажмите кнопку «Да», чтобы утвердить эту установку.)
Когда установка завершится, перейдите к следующему шагу — выбору WSL 2 в качестве версии по умолчанию при установке новых дистрибутивов Linux. (Пропустите этот шаг, если вы хотите, чтобы новые дистрибутивы Linux были установлены в WSL 1).
Шаг 5. Выбор WSL 2 в качестве версии по умолчанию
Откройте PowerShell и выполните следующую команду, чтобы задать WSL 2 в качестве версии по умолчанию при установке нового дистрибутива Linux:
Шаг 6. Установка дистрибутива Linux по выбору
Откройте Microsoft Store и выберите предпочтительный дистрибутив Linux.
Ниже приведены ссылки на страницы Microsoft Store для каждого дистрибутива:
На странице дистрибутива щелкните «Получить».
При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать минуту или две, чтобы файлы распаковались и сохранились на компьютере. Все будущие запуски должны занимать меньше секунды.
Поздравляем! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows.
Установка Терминала Windows (необязательно)
В Терминале Windows можно использовать несколько вкладок (чтобы быстро переходить между несколькими командными строками Linux, командной строкой Windows, PowerShell, Azure CLI и пр.), создавать пользовательские сочетания клавиш (для открытия и закрытия вкладок, копирования и вставки и пр.), а также применять функцию поиска и пользовательские темы (цветовые схемы, стили и размеры шрифтов, а также фоновое изображение, размытие и прозрачность). Подробнее.
Установите вашу версию дистрибутива на WSL 1 или WSL 2
Чтобы настроить дистрибутив для одной из версий WSL, выполните:
Не забудьте заменить на фактическое имя дистрибутива и с номером «1» или «2». Вы можете всегда вернуться к WSL версии 1, выполнив эту команду и заменив «2» на «1».
[!NOTE] Обновление с WSL 1 до WSL 2 может занять несколько минут в зависимости от размера целевого дистрибутива. Если вы используете устаревшую установку WSL 1 из Юбилейного обновления Windows 10 или обновления Creators Update, может возникнуть ошибка обновления. Выполните эти инструкции, чтобы удалить устаревшие дистрибутивы.
Кроме того, если вы хотите сделать WSL 2 архитектурой по умолчанию, выполните следующую команду:
Будет установлена версия любого нового дистрибутива, установленного в WSL 2.
Устранение неполадок установки
Ниже перечислены возможные ошибки и способы их устранения. Другие распространенные ошибки и способы их устранения приведены в разделе Устранение неполадок подсистемы Windows для Linux.
Сбой установки с ошибкой 0x80070003
Сбой WslRegisterDistribution с ошибкой 0x8007019e
Сбой установки с ошибкой 0x80070003 или ошибкой 0x80370102.
Запрошенную операцию не удалось выполнить из-за ограничения системы виртуального диска. Файлы виртуального жесткого диска должны быть распакованными, незашифрованными и не разреженными.
[!NOTE] В этом примере папка LocalState для дистрибутива Ubuntu 18.04 расположена по адресу C:\Users \AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc
Чтобы получать обновленные сведения, проверьте ветку № 4103 в документации GitHub WSL, где отслеживается эта проблема.
Термин WSL не распознан как имя командлета, функции, файла скрипта или действующей программы.
Error: This update only applies to machines with the Windows Subsystem for Linux (Ошибка. Это обновление применяется только к компьютерам с подсистемой Windows для Linux).
Вы используете старую версию Windows, которая не поддерживает WSL 2. Требования к версиям и ссылки пакеты обновления см. на шаге 2.
Компонент WSL не включен. Необходимо вернуться к шагу 1 и убедиться, что на компьютере включен необязательный компонент WSL.
Когда он будет включен, перезагрузите компьютер, чтобы изменения вступили в силу, и повторите попытку.