Skip to content
Navigation Menu
Provide feedback
Saved searches
Use saved searches to filter your results more quickly
Sign up
Appearance settings
Description
Version
Microsoft Windows [Version 10.0.22621.963]
WSL Version
- WSL 2
- WSL 1
Kernel Version
No response
Distro Version
No response
Other Software
No response
Repro Steps
wsl —install
Expected Behavior
WSL is installed
Actual Behavior
Installing: Windows Subsystem for Linux
[ 0.0% ]
for many minutes, no visible CPU usage or anything
also tried installing via Microsoft Store, stuck at pending there
Diagnostic Logs
WslLogs-2022-12-23_00-12-56.zip
После установки Windows Subsystem for Linux (Подсистема Windows для Linux) и какого-либо дистрибутива Linux после его запуска вы можете получить сообщение об ошибке «WslRegisterDistribution failed with error» и каким-либо кодом ошибки: 0x80370114, 0x80370102, 0x8007019e, 0x800706be, 0x8000000d или другим.
В этой инструкции подробно о способах исправить такие ошибки и запустить Ubuntu, Debian или другой дистрибутив в WSL в Windows 11 и Windows 10.
Простые способы исправить ошибки WslRegisterDistribution
Сначала некоторые простые способы исправить проблему, которые могут сработать при ошибках «WslRegisterDistribution failed with error»:
- Если вы только что установили WSL и дистрибутив Linux, но не выполняли перезагрузку компьютера — выполните её и попробуйте снова: вполне возможно, всё заработает исправно.
- Убедитесь, что виртуализация включена в БИОС/UEFI компьютера, подробнее: Как включить виртуализацию.
- Установите обновление Подсистемы Windows для Linux с сайта Майкрософт.
- Попробуйте по порядку выполнить две команды:
wsl --update wsl --shutdown
в командной строке, запущенной от имени администратора.
- Установите доступные обновления Windows, если они давно не устанавливались, это действительно может сработать.
Дополнительно, если вы устанавливаете WSL в Windows, которая установлена в виртуальной машине, виртуализация должна быть включена и в ней. Например, в Hyper-V потребуется включить Nested Virtualization с помощью команды PowerShell:
Set-VMProcessor -VMName ИМЯ_ВМ -ExposeVirtualizationExtensions $true
Дополнительные варианты решения
Если предыдущие варианты не помогли, выполните следующие команды в командной строке, запущенной от имени администратора (если первая команда сообщит о том, что установка уже выполнена, перейдите к следующим командам):
wsl --install dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart wsl --set-default-version 2
Если ошибка появилась на версии WSL 2, можно, наоборот, попробовать переключение на 1-ю версию в последней команде.
В некоторых случаях могут сработать следующие подходы:
- Используйте команду
bcdedit /set hypervisorlaunchtype auto
в командной строке, запущенной от имени администратора с последующей обязательной перезагрузкой компьютера.
- В Параметры — Приложения в списке установленных приложений откройте дополнительные параметры вашего дистрибутива Linux и используйте опцию «Сброс». Если это не помогло, можно попробовать удалить приложение, соответствующее дистрибутиву и установить его с помощью команд wsl или из Microsoft Store.
- Проверьте, появляются ли ошибки, если использовать другой дистрибутив Linux для WSL.
- Некоторые пользователи сообщают о том, что им помогает отключение компонентов «Платформа виртуальной машины», «Подсистема Windows для Linux» (и, если включен — Hyper-V), перезагрузка, повторное включение этих компонентов и повторная перезагрузка компьютера.
Надеюсь, один из предложенных вариантов поможет решить проблему. Будет отлично, если вы сможете поделиться в комментариях тем способом, который сработал для вашего случая.
Finally, after a lot of thoughtful discussion between Microsoft and Linux, we got to see the much-needed Linux integration in the latest Windows 11. You can now run Linux commands and tools natively on your Windows 11 PC. Most users are enjoying the WSL integration by installing their favorite Linux program on their system.
But sadly, some users are still facing difficulties running their preferred Linux distribution on their Windows PC. After getting to know about these WSL-related issues, we researched more about them in detail and also found some possible workarounds that can fix them. To help you out, we’ve also mentioned those possible workarounds in this troubleshooting guide.
Why Is Windows Subsystem for Linux (WSL) Not Working Properly?
Here are some of the most common reasons behind the non-functioning of the Windows Subsystem for Linux (WSL) in Windows 11. Check them below:
- WSL Is Disabled on Your System
- Virtual Machine Platform & Hyper V Feature Is Disabled
- Corrupt Linux App Installation
- Malware & Viruses
- Faulty Windows Update
- Windows Firewall Restrictions
Fix Windows Subsystem for Linux Not Working in Windows 11
Here in this section, we’ve mentioned more than 15 workarounds that can fix the Windows Subsystem for Linux not working issue in your Windows 11 PC.
1. Make Sure Your Computer Can Run WSL
While searching for some solutions, we found that many users are facing difficulties in installing WSL 2, which is the latest version of WSL. When we dug deep into this issue to learn more about this, we found out that WSL 2 can only be run on systems having the Second Level Address Translation (SLAT) feature.
If you’re also unable to install WSL 2 on your Windows 11 PC, then this could be the same with you. Another requirement to run WSL 2 is that your system should be running on the latest generations of CPUs. If your system doesn’t meet the minimum requirements, you can’t run WSL 2 on it.
2. Ensure WSl Is Running on the Main Storage
Many users reported that when they try to install WSL on their Windows machine, the installation process suddenly fails, and they see the 0x80070003 error code on the screen. The most common reason for this error is not allowing the Windows Subsystem for Linux to run on the system’s primary storage drive, which is C: drive.
If the same error appeared in your case while installing WSL, then we suggest you make sure that it’s allowed to use the system’s primary storage drive. You can follow the below-mentioned steps to know how to check the same:
1. Open the Settings app on your Windows 11 PC using the Windows + I shortcut and move to the Storage section.
2. Next, expand the Advanced storage settings subsection of the Storage management section.
3. Now, expand the Where new content is saved subsection under the Advanced storage settings section.
4. In the Advanced storage settings section, select your system’s primary storage drive from the New apps will save to: dropdown menu and close the window.
Once you’ve made sure that WSL is allowed to use the primary storage drive, check if you can now install WSL on your Windows 11 PC.
3. Scan for Viruses & Malware on Your Computer
During the research, we found that the viruses and malware in the system can also prevent system’s essential components from functioning properly, which can lead to this issue. This could be the same in your case and, to avoid this, we suggest scanning the entire system and making sure no infected files are stored in it.
You can use the Windows’ built-in Malware Removal tool to scan for infected files on your PC and remove them. Follow the steps below to know how to do the same:
1. Open the Settings app on your Windows 11 PC using any method you want and proceed to the Privacy & security section.
2. Once you’ve moved to the Privacy & security section, click on Windows Security and then click on the Open Windows Security option.
3. In the Virus & threat protection section, click on Scan options and then select the scan type to Full scan.
4. In the end, click on Scan now to begin the scan process and wait until the scan gets completed.
5. Once the malware scan is completed, you’ll see the scan results on the same screen. If the scanner process finds some harmful files on the system, you can quarantine them or remove them from the computer.
After doing the same, check the issue’s status.
4. Re-enable Windows Subsystem for Linux (WSL)
One of the most common yet effective solutions to overcome these WSL-related issues is to re-enable WSL on your Windows 11 PC. Doing so will reinstate all the WSL components and ensure the same issues don’t appear. We’ve mentioned one of the easiest methods to re-enable WSL on a Windows 11 PC below:
1. First, open Control Panel on your Windows 11 PC and navigate to the Programs section from the home screen.
2. In the Programs section, select the Programs and Features section and click Turn Windows features on or off.
3. Search for the Windows Subsystem for Linux checkbox in the Windows Features pop-up and re-enable it.
Once you’ve re-enabled the Windows Subsystem for Linux feature, check if you’re now able to install and run Linux on your Windows 11 PC.
5. Make Sure the Virtual Machine Platform Feature Is Enabled
According to Microsoft, the Virtual Machine Platform feature should be enabled on your Windows PC to run WSL smoothly. Therefore, we suggest you ensure that this feature is enabled on your Windows 11 PC. You can take a look at the steps below to ensure this feature is enabled on your PC:
1. To do so, move to the Programs and Features section in the Control Panel program and select Turn Windows features on or off from the left sidebar.
2. Now, search for the Virtual Machine Platform option in the Windows Features pop-up and re-enable it by re-ticking it.
After re-enabling the Virtual Machine Platform feature on your Windows PC, restart it and check if WSL is working fine or not.
6. Ensure Hyper-V Is Enabled
Hyper V, also known as Hypervisor, is a Windows feature that lets you create and run virtual machines on your Windows PC. To install and run WSL on your Windows 11 PC, the Hyper V feature must be enabled on your PC.
It could be possible that the Hyper V functionality is disabled on your PC, which is why this issue is occurring. You can check the same from Control Panel, and the below-mentioned steps demonstrate the same:
1. First, open the Control Panel app on your Windows computer and navigate to the Turn Windows features on or off section from the left sidebar.
2. Locate the Windows Hypervisor Platform feature in the Windows Features dialog box and re-enable it.
You should now be able to run and install different Linux distributions on your Windows 11 computer with ease.
7. Turn On Hardware Virtualization
In simple terms, Hardware Virtualization is a Windows component that helps you run different subsystems, like WSL, effectively on your PC. Along with the Windows Hyper Hypervisor Platform and Virtual Machine Platform feature, it’s essential to keep the Hardware Virtualization feature enabled to run different operating systems seamlessly. You need to make sure that this functionality is enabled on your Windows PC. The same thing can be ensured by following the below-mentioned steps:
1. First, open the Task Manager program on your Windows 11 PC and head to the CPU section from the home screen.
2. Now, in the CPU section, make sure the Virtualization option is enabled.
Once you’ve turned on the Hardware Virtualization functionality on your Windows 11 PC, check if everything WSL is working fine now.
8. Disable the Use Legacy Console Mode
Some users reported when they try to install WSL on their Windows PC; they get the 0x80040306 error code in the console. If that’s the same with you, then it has something to do with the Legacy Console mode.
In layman’s language, Legacy Console is a Windows tool that helps you install and use command-line tools on your Windows computer. In some cases, it’s found that the Legacy Console mode conflicts with WSL components and leads to these issues.
In that case, we suggest disabling the Legacy Console mode option on your Windows 11 computer. Follow the steps below to easily disable the Legacy Console mode on your computer:
1. Open the Command Prompt app on your Windows 11 PC, right-click on the title bar, and choose the Properties option.
2. Once the Properties section is opened, untick the Use legacy console checkbox and click on OK.
After disabling the Use legacy console mode, confirm if the issues with WSL are resolved or not. We hope they’re fixed now.
9. Disable the BitLocker Device Encryption Feature
Bitlocker Device Encryption is a Windows security feature that protects the operating system and its data from data theft, loss, and other kinds of losses. During our research, we found that the Bitlocker Device Encryption feature can impose limitations on WSL and stop it from functioning properly.
In that case, we suggest disabling the Bitlocker Device Encryption feature on your PC and checking if it fixes the issue. Follow the mentioned instructions to learn how to do the same in a few simple steps:
1. Open the Start Menu on your Windows 11 PC, search for Control Panel and select the app from the Best match section.
2. Then, head to the System and Security section and select the BitLocker Drive Encryption option from the present choices.
3. In the end, select the Turn off BitLocker option under the Operating system drive section to disable it.
After disabling this option, check if the issue is fixed. If it’s still not fixed, consider re-enabling the BitLocker Drive Encryption feature.
10. Ask Windows Firewall To Not Block WSL
Some users said that when they connect their PC to a VPN and open Linux, the bash automatically loses access to the network and stops working. In their case, the system’s own Firewall was preventing the app from accessing the internet and functioning correctly.
It could be the same in your case, and you can check this by disabling the Windows built-in Firewall. So, follow the below-mentioned steps to disable the Windows built-in Defender Firewall:
1. To do so, open the Control Panel app on your PC and navigate to the System and Security section to access the computer’s security settings.
2. Then, move to the Windows Defender Firewall section and choose the Turn Windows Defender Firewall on or off option.
3. At last, set the Private network settings and Public network settings option to turn off Windows Defender Firewall (not recommended).
3. Alternatively, execute the below command in the elevated Command Prompt to disable the system’s integrated Firewall.
netsh advfirewall set allprofiles state off11. Restart the LxssManager Service
LxssManager is an essential Windows service that enables you to run native ELF binaries on your system with ease. If this service faces issues in functioning properly, then it can prevent WSL from working correctly. It could be possible that the LxssManager service isn’t functioning properly, which is why you’re going through this inconvenience.
Fortunately, you can restart the LxssManager service to see if it is of any help. Follow the mentioned instructions to learn how to reinstate the LxssManager service in a few simple steps:
1. Firstly, open the Windows Search Box, type Services in it, and select the same from the search results.
2. Now, look for the LxssManager service in the Services section and right-click on it to open the dropdown menu.
3. In the end, select the Stop option from the pop-up menu and relaunch WSL to restart the service to fix it.
12. Launch WSL from Microsoft Store
If you can’t open WSL or Linux distribution on your PC from the Taskbar or Windows Search Box, then we suggest launching it from the Microsoft Store. It could be possible that there’s a glitch with the distribution program, which is why the program isn’t opening. You can follow the below steps to open WSL from the official Microsoft Store:
1. Open the Microsoft Store on your PC.
2. Click the Library icon at the bottom left corner of the screen.
3. Now, look for the Windows Subsystem for Linux app in the Apps section and click on Open next to it.
13. Reset & Repair the Linux Distribution App
It could be possible that the Linux distribution app has been corrupted, which is why these issues are appearing. The best solution to fix the corrupted data is to repair the affected Linux distribution app.
Fortunately, your Windows system allows you to easily repair and reset apps from the system’s Settings. You can follow the below-mentioned steps to reset and repair your Linux distribution app without putting much effort:
1. Open the Settings app on your Windows PC and move to the Apps section from the left navigation menu.
2. Then, head to the Installed apps section and search for the Linux distribution app you’re facing issues with.
3. Next, click on three dots (…) or More options next to the app and select the Advanced options from the dropdown menu.
4. In the Advanced options section, move to the Reset section and click on Repair to start repairing the app.
5. Lastly, click on the Reset option in the Reset section to clear the app’s cache and data from the computer.
The previously affected Linux distribution app must be working fine now.
14. Update Linux Using Windows Terminal
Many users said updating WSL and the Linux distribution program to the latest version fixed the issue for them. Keeping this in mind, we also suggest you update WSL to the latest version to see if it makes some improvements.
Doing so will update all the WSL components and its kernel version to the most current version. You can check the steps below if you need some assistance:
1. To update WSL, open the elevated Windows PowerShell and CMD on your Windows PC and run the mentioned command in the console.
wsl --update2. Once you’ve updated WSL, execute the below command in the Linux distribution to update the Linux distribution user binaries.
apt-get update | apt-get upgradeOnce done, check the issue’s status.
15. Reinstall Linux distribution
If updating the Linux distribution doesn’t resolve the WSL not working issue, you can then consider reinstalling it. Doing so will completely remove the program and its existing data from the system and resolve the problem. So, you can try reinstalling your Linux distribution on your Windows 11 PC following the mentioned steps:
1. To start, open the elevated Command Prompt or Windows PowerShell on your PC and run the mentioned command in the console.
wls --list --all2. Next, execute the mentioned command in the console. But replace <DistributionName> with the Linux distribution installed on your system. For instance, we’ve installed Kali Linux on our Windows system, so we’ll replace <DistributionName> with Kali Linux.
3. Once you’ve completely removed the distribution from your system, move to Microsoft Store and reinstall it.
After reinstalling the Linux distribution on the system, you should be able to use Linux without any issues now.
16. Uninstall Faulty Windows Updates (Optional)
For some users, these issues with WSL started occurring after updating the PC to another version. If that’s the same in your case, then we suggest removing the malfunctioned Windows update from the system.
But before following the mentioned steps, you should know after which update the issue started appearing. Once you’ve found this out, follow the mentioned step to uninstall the faulty Windows update from your PC:
1. Firstly, move to Settings of your Windows PC and select Windows Update from the left navigation menu.
2. Now, proceed to the Update history section and then move to the Uninstall updates section to view the updates that can be uninstalled.
3. In the end, click on Uninstall next to the Windows update you want to uninstall and again select Uninstall to remove it from the system.
Once done, restart the computer, and confirm whether the issue is fixed.
17. Update Your Windows 11 PC To the Latest Version
It could be possible that these issues are appearing because of some bugs in the essential WSL components. Microsoft keeps pushing new updates to fix these bugs and to make Windows more efficient and stable. You can also try to search for new Windows 11 updates and install them to see if it resolves the issues: Here are the steps to do the same in a few simple steps:
1. To start, open the Settings app on your Windows 11 PC and proceed to Windows Update from the left navigation pane.
2. Click on the Check for updates option in the Windows Update section to search for new system updates.
3. If Windows finds and shows some new updates on the screen, click on Download & install all to install them on your Windows PC.
Once you’ve updated your Windows 11 PC to the latest build, restart it and try installing WSL again on the system.
Frequently Asked Questions
Will WSL Work on Windows 11?
Yes, the Windows Subsystem for Linux (WSL) function works on both Windows 11 and Windows 10. But your Windows 11 PC must meet the minimum installation requirements to install and enable the WSL.
How Do I Know if WSL Is Installed on Windows 11?
To check whether Windows Subsystem for Linux is installed on your Windows 11 PC, run the wsl --install command in the elevated Command Prompt or PowerShell program. If it’s already installed on your computer, it’ll display a message explaining WSL is already installed on your Windows 11 system.
How Do I Enable WSL in Windows 11?
To turn on WSL on your Windows 11 PC, move to Control Panel > Programs > Programs & Features > Turn Windows Features on or off section and tick the Windows Subsystem for Linux checkbox. You can also download the Windows Subsystem for Linux app from the Microsoft Store on your Windows 11 computer to enable WSL.
How Do I Fix WSL Error 0x80370102?
If you get the 0x80370102 error while using WSL on your Windows 11 PC, then we suggest making sure that the Virtual Machine Platform feature is enabled on your computer. You can execute the mentioned command in the elevated CMD or PowerShell to enable the Virtual Machine Platform option on your Windows PC.
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartFinally, WSL Is Working Properly Now
We all always wanted to use our favorite Linux distribution on our Windows PC without creating any virtual machine. And even Microsoft tried to make it possible, and they were successful too in doing so. But like every other virtualization program, it may also have some issues.
Many users are experiencing issues in installing and running WSL on their Windows machines. If you were also facing the same issues with WSL on your system, then we hope the mentioned solutions helped you fix the issue. Also, before leaving this guide, let us know which of the mentioned workarounds worked for you.
Среда Windows Subsystem for Linux (WSL) позволяет запускать нативные приложения, писать скрипты, выполнять команды и скрипты Linux непосредственно из Windows без использования эмуляторов или развертывания выделенных виртуальных машин. Актуальной версией среды является WSL 2, в которой используется полноценное ядро Linux (версия ядра 5.15) и обеспечивает полную совместимость с системными вызовами. Образ ядра Linux в WSL представляет собой легкую виртуальную машину, для запуска которой не нужно устанавливать полноценную роль Hyper-V.
Содержание:
- Как установить Windows Subsystem for Linux (WSL2)?
- WSL: Установка дистрибутива Linux в Windows
- Команды для управления WSL в Windows
- Использование Linux в среде WSL
Вы можете запустить WSL 2:
- Во всех версиях Windows 10, начиная с 1903, а также в Windows 11 и Windows Server 2022;
- В настройка BIOS/UEFI компьютера должна быть включена поддержка аппаратной виртуализации: Intel VT (Intel Virtualization Technology) или AMD-V (SVM Mode).
Как установить Windows Subsystem for Linux (WSL2)?
Компонент WSL по умолчанию отключен в Windows. Современных дистрибутивах Windows 10 и Windows 11 для установки среды WSL достаточно выполнить команду:
wsl --install
Этак команда автоматически включит все необходимые компоненты Windows, необходимые для работы WSL, установить обновление ядра Linux для WSL2, загрузит дистрибутив Ubuntu (по-умолчанию) и установит его в WSL.
Осталось перезагрузить компьютер, и вы можете запускать среду WSL!
Вы можете установить для WSL другой дистрибутив Linux. Выведите список доступных дистрибутивов:
wsl --list --online
Укажите имя дистрибутива Linux, который установить в WSL. Например:
wsl --install -d kali-linux
Если в BIOS/UEFI компьютера не включена виртуализация, при установке WSL вы получите ошибку:
Installation failed with error 0x80070003 or error 0x80370102” it means that Bios Level Virtualization is not enabled on your computer.
Вы можете установить WSL2 в Windows вручную. Для этого придется вручную последовательно выполнить все этапы, который команда wsl —install запускала автоматически:
- Установить WSL
- Включить компонент виртуалзации VirtualMachinePlatform
- Установить ядро WSL 2
- Скачать и установить дистрибутив Linux для WSL
Сначала установите следующие компоненты Windows:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
Перезагрузите компьютер.
Скачаем и установим обновление ядра Linux для WSL2 (WSL2 Linux kernel update package for x64 machines — https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi). Можете скачать пакет вручную или с помощью PowerShell:
Invoke-WebRequest -Uri https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi -OutFile "$($env:userprofile)\Downloads\wsl_update_x64.msi" -UseBasicParsing
Invoke-Item "$($env:userprofile)\Downloads\wsl_update_x64.msi"
rm "$($env:userprofile)\Downloads\wsl_update_x64.msi"
Еще раз перезагрузите компьютер и назначьте версию WSL 2 в качестве среды по-умолчанию:
wsl --set-default-version 2
WSL: Установка дистрибутива Linux в Windows
После того, как ядро WSL установлено в Windows, вы можете установить один или несколько дистрибутивов Linux на компьютер.
Можно установить пакет с дистрибутивом Linux через Microsoft Store. Доступны следующие дистрибутивы:
- Ubuntu
- Debian
- Kali Linux
- OpenSUSE
- Oracle Linux
- SUSE Linux Enterprise Server
- Fedora
Найдите нужную версию дистрибутива в Store и установите ее, нажав кнопку Получить (Get).
Если у вас отключен Windows Store, вы хотите установить дистрибутив WSL в Core редакции Windows Server или вам нужно установить WSL на Изолированном от интернета компьютере (оффлайн), вы можете скачать дистрибутив Ubuntu с помощью PowerShell командлета Invoke-WebRequest:
Invoke-WebRequest https://aka.ms/wslubuntu2204 -OutFile ubuntu-2204.appx –UseBasicParsing
Установите пакет для WSL с помощью:
Add-AppxPackage .\ubuntu-2204.appx
После окончания установки появится окно, в котором вам будет предложено указать имя пользователя и пароль для вашего дистрибутива.
После установки вы можете в меню Пуск появится отдельная программа для запуска Linux.
Также вы можете запустить ваш Linux из отдельной вкладки Windows Terminal или с помощью команды
wsl
.
Команды для управления WSL в Windows
Рассмотрим основные команды для управления ядром и дистрибутивами Linux в WSL.
Проверить текущую версию ядра WSL:
wsl --version
Обновить ядро WSL вручную:
wsl --update
Откатится к предыдущему ядру WSL:
wsl --update rollback
Вывести список установленных версий Linux:
wsl --list
Вывести дистрибутив Linux, который используется по-умолчанию:
wsl --status
Дистрибутив Linux по-умолчанию в WSL можно изменить:
wsl --setdefault Ubuntu
Запустить определенный дистрибутив в WSL:
wsl -d kali-linux
Завершить среду WSL:
wsl --shutdown
Можно войти в WSL Ubuntu под root и сбросить пароль:
ubuntu config --default-user root
Passwd
Вернуть пользователя по умолчанию
ubuntu config --default-user your_username
Для настройки параметров WSL и дистрибутивов Linux используются конфиг файлы:
- wsl.conf – файл с настройками конкретного дистрибутива Linux (находится в директории /etc)
- .wslconfig – глобальные настройки WSL, которые применяются ко всем дистрибутовам (находится в профиле пользователя в
%UserProfile%
)
Например, если вы хотите ограничить использование оперативной памяти и CPU компьютера дистрибутивами Linux в WSL, создайте такой файл
%UserProfile%\.wslconfig
:
[wsl2] memory=2GB processors=2
Использование Linux в среде WSL
Дистрибутив Linux, установленный в WSL является полноценной операционной системой. Поэтому после установки рекомендуется выполнить обновление пакетов. Для Ubuntu выполните команду:
$ sudo apt-get update && sudo apt-get upgrade -y
Файловая система вашего дистрибутива Linux хранится в профиле пользователя в виде VHDX файла. Например, виртуальный диск Ubuntu хранится в папке
%USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu_79rhkp1fndgsc\LocalState
Файловая система Linux в WSL монтируется в виде сетевой папки прямо в проводник Windows.
Также для прямого доступа к файлам WSL из Windows можно использовать UNC путь. Например:
notepad \\wsl$\Ubuntu\sysops\home\1122.txt
В свою очередь локальные диски Windows монтируются в WSL в папку mnt. Вывести список файлов папок на диске C:
wsl
ls /mnt
ls/mnt/c
Другие примеры запуска Linux команд из Windows:
dir | wsl grep Sa
wsl ls ‑la > 123.txt
wsl ls ‑la /proc/cpuinfo
wsl ls ‑la “/mnt/c/Program Files”
Вы можете установить любые пакеты в Linux. Например, установите файловый менеджер Midnight Commander:
$ sudo apt-get install mc
В современной версии WSL 2 вы можете запускать из Windows любые приложения Linux с графическим интерфейсом (X11 и Wayland). Например, установите графический редактор:
$ sudo apt install gimp -y
Чтобы запустить его из Windows просто выполните команду:
wsl gimp
Все способы:
- Способ 1: Автоматически (с параметрами по умолчанию)
- Способ 2: Вручную (+ дистрибутив Linux по выбору)
- Шаг 1: Включение аппаратной виртуализации
- Шаг 2: Активация компонентов Win 11
- Шаг 3: Апдейт ядра WSL
- Шаг 4: Определение WSL2 как версии подсистемы по умолчанию
- Шаг 5: Скачивание и инсталляция дистрибутива Linux по выбору
- Вопросы и ответы: 1
Способ 1: Автоматически (с параметрами по умолчанию)
Ещё до выхода ОС Windows 11 механизм установки «Подсистемы Windows для Linux» (WSL2) был существенно упрощён разработчиками из Microsoft. Так, активировать в системе платформу виртуальной машины, инсталлировать саму подсистему и ядро WSL, а также развернуть дистрибутив Linux (по умолчанию – Ubuntu) возможно путём запуска всего лишь одной консольной команды. Использовать следующий подход к достижению поставленной в заголовке этой статьи цели рекомендуется в первую очередь, к тому же полученных по итогу возможностей оказывается достаточно большинству пользователей.
- Открываем интегрированное в Виндовс 11 приложение для доступа к запуску команд «PowerShell» под названием «Терминал». Выполнить это необходимо от имени Администратора, а проще всего — из меню дополнительных функций кнопки «Пуск» на «Панели задач»:
Читайте также: Как открыть приложение «Терминал» в Windows 11
- Пишем в «Терминале» команду следующего содержания:
wsl --install - Нажимаем «Enter» на клавиатуре, чтобы отправить введённое в консоль указание на выполнение системой. Далее ждём, пока будет осуществлено поэтапное автоматизированное развёртывание в Win 11 всего необходимого для функционирования WSL2:
- Получив в консоли сообщение «Требуемая операция выполнена успешно»,
перезагружаем компьютер. С такой целью можно:
- Ввести в «Терминал» следующую команду и затем нажать «Enter» на клавиатуре:
Restart-Computer - Или закрыть окно «Терминала» и выполнить перезапуск ПК любым привычным способом,
к примеру, через меню «Пуск» Виндовс 11.
Читайте также: Как перезагрузить компьютер под управлением Windows 11
- Ввести в «Терминал» следующую команду и затем нажать «Enter» на клавиатуре:
- По завершении перезапуска ОС
автоматически откроется окно консоли Windows, — ещё немного ожидаем, пока завершится распаковка и инсталляция дистрибутива Ubuntu в WSL 2.
- Получив приглашение «Enter new UNIX username»,
вводим в командную строку назначаемое для эксплуатации в среде Linux имя пользователя, нажимаем «Ввод» на клавиатуре.
- Далее придумываем (и запоминаем), а затем пишем в консоли пароль для доступа в установленную в WSL2 Linux (Ubuntu), передаём его системе, нажав «Enter». (Возможно, стоит обратить внимание, что вводимая секретная комбинация в Linux-системах не отображается даже завуалировано.)
- Вводим и отправляем системе пароль из шага выше повторно.
- По сути, на этом всё — WSL2 в Windows 11 установлена и запущена, а полученный с её помощью дистрибутив Ubuntu
функционирует и готов к выполнению задач пользователя.
- Впоследствии запустить WSL2 и одновременно инсталлированный в ней дистрибутив Linux можно разными путями:
- Открываем «Главное меню» Win11, перемещаемся в перечень «Все приложения»,
находим в нём название Linux-системы («Ubuntu») и кликаем по её наименованию.
- Запускаем «Терминал» (к слову, можно и классическую «Командную строку») от имени Администратора,
в качестве команды пишем название установленного в системе Linux-дистрибутива, (например,
Ubuntu),
нажимаем «Ввод» на клавиатуре.
Читайте также: Как запустить классическую «Командную строку» в Windows 11 от имени Администратора
- Запускаем выполнение консолью следующей команды:
wsl
Данное указание приводит к запуску назначенного в «Подсистеме Windows для Linux» по умолчанию дистрибутива последней.
- Открываем «Главное меню» Win11, перемещаемся в перечень «Все приложения»,
При необходимости (сразу или в дальнейшем) получения доступа к отличным от предлагаемого «Подсистемой Windows для Linux» по умолчанию Ubuntu дистрибутивам Линукс выполняем их инсталляцию одним из предложенных «Шагом 5» второго в этой статье «Способа» установки WSL 2 в Win 11.
Способ 2: Вручную (+ дистрибутив Linux по выбору)
При возникновении каких-либо проблем с установкой WSL2 в Windows 11 вышеописанным образом (либо, к примеру, желании реализовать рассматриваемую процедуру более осознанно) выполняется поэтапное развёртывание подсистемы.
Шаг 1: Включение аппаратной виртуализации
Важным требованием для запуска и эксплуатации WSL 2 в Windows 11 является доступность в системе поддержки аппаратной виртуализации. Поэтому в первую очередь проверяем факт выполненности данного условия, а в противном случае включаем указанную опцию в BIOS (UEFI) ПК. Для проверки активированности аппаратной виртуализации в Виндовс 11 проще всего будет воспользоваться функциональностью «Диспетчера задач» («ДЗ»):
- Любым способом (к примеру, из контекстного меню расположенного на «Панели задач» Win 11 элемента «Пуск» или нажав «Ctrl»+«Shift»+«Esc» на клавиатуре) запускаем «Диспетчер задач».
Подробнее: Как открыть «Диспетчер задач» в Windows 11
- Из меню разделов «ДЗ» (открывается в результате клика по трём чёрточкам вверху слева окна) перемещаемся в «Производительность».
- Кликаем «ЦП» в перечне аппаратных компонентов системы, которые мониторит «Диспетчер задач», затем перемещаемся в правую нижнюю область окна и смотрим на значение отображаемого здесь среди прочих параметра «Виртуализация».
- Если аппаратная виртуализация «Включена», можно переходить к выполнению следующего этапа реализации настоящих рекомендаций. Если же в качестве значения рассматриваемого параметра указано «Выключено», следует завершить работу компьютера, открыть программу управления параметрами BIOS и активировать опцию «Intel VT» или «AMD-V» её средствами.
Подробнее: Включаем поддержку аппаратной виртуализации в BIOS компьютера
Шаг 2: Активация компонентов Win 11
Включение WSL 2 в Windows 11 требует получения и активации двух необязательных компонентов операционной системы: самой «Подсистемы Виндовс для Линукс», а также «Платформы виртуальных машин». Реализовать это возможно двухвариантно.
Элемент «Панели управления»
Загрузку и включение практически любого необязательного компонента Windows 11 проще всего осуществлять при помощи специализированного инструментария с графическим интерфейсом, и в случае с рассматриваемой подсистемой, а также необходимой для её функционирования платформой это справедливо в полной мере.
Читайте также: Включение или отключение необязательных компонентов Windows 11
- Вызываем предназначенный для активации/деактивации компонентов Win 11 элемент «Панели управления» ОС. Один из возможных путей к данной цели:
- Прокручиваем отображаемый окном «Включение или отключение компонентов Windows» список, находим в нём «Платформа виртуальной машины»,
ставим галочку в чекбоксе слева от этой записи.
- Пролистываем перечень доступных к включению/выключению компонентов операционки далее,
отмечаем чекбокс «Подсистема Windows для Linux».
- Далее нажимаем «ОК» в окошке средства управления компонентами ОС,
ожидаем, пока Виндовс 11 автоматически выполнит необходимые для затребованной операции действия (скачает и сохранит на ПК нужные файлы).
- Получив сообщение «Windows применила требуемые изменения», кликаем «Перезагрузить сейчас» внизу отображающего его окна.
- Ожидаем окончания перезагрузки компьютера,
в её процессе будет осуществлена непосредственная интеграция «Подсистемы Windows для Linux», а также «Платформы виртуальной машины» в операционную систему.
Консоль Виндовс 11 (DISM)
Более сложный, но в некоторых случаях предпочтительный, путь к включению необходимых для функционирования WSL 2 компонентов Windows 11 осуществляется средствами программы командной строки для обслуживания образов ОС от Microsoft под названием DISM.
- Запускаем приложение «Терминал» с повышенными привилегиями (от имени Администратора).
- Копируем из текста настоящей статьи, вставляем в консоль и отправляем на выполнение команду загрузки и интеграции компонента «Подсистема Windows для Linux»:
Dism /online /Enable-Feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
Ожидаем, пока в консоли заполнится процентный индикатор «Включение функций»
и затем отобразится оповещение «Операция успешно завершена».
- Далее устанавливаем компонент операционки «Платформа виртуальной машины», — команда будет следующей:
Dism /online /Enable-Feature /featurename:VirtualMachinePlatform /all /norestart
По аналогии с включением «Подсистемы Виндовс для Линукс»: отправляем команду интегрировать «Платформу виртуальной машины» на выполнение,
дожидаемся сообщения «Операция успешно завершена».
- Для завершения активации рассматриваемых компонентов Win 11, после выполнения вышеуказанного необходимо перезагрузить ПК. В текущей ситуации с такой целью проще всего будет запустить через «Терминал» следующую команду:
Restart-Computer
Дождавшись перезапуска ПК,
переходим к следующему шагу по настройке WSL2.
Шаг 3: Апдейт ядра WSL
Ещё один необходимый этап процесса установки WSL2 — это обновление ядра подсистемы. С такой целью следует задействовать специализированный и всегда доступный к загрузке с серверов Microsoft инсталлятор.
Пакет обновления ядра Linux в WSL 2 для 64-разрядных компьютеров.
- Переходим по ссылке выше, что инициирует скачивание апдейтера WSL до последней версии,
сохраняем его на диск ПК в любую папку.
- Двойным кликом в Проводнике Windows открываем полученный в результате выполнения предыдущего пункта инструкции файл wsl_update_x64.msi.
- Кликаем «Next» в отобразившемся окне Мастера инсталляции WSL Update, чтобы подтвердить запуск апдейтера,
нажимаем «Да» в ответ на запрос «Контроля учётных записей».
- Некоторое время ждём окончания процедуры копирования файлов,
кликаем «Finish» в окне с уведомлением «Completed the Windows Subsystem for Linux Update Setup Wizard».
Шаг 4: Определение WSL2 как версии подсистемы по умолчанию
Немаловажное действие на пути к результативному запуску современных дистрибутивов Linux в среде Windows 11 – это установка WSL2 в качестве используемой по умолчанию версии рассматриваемой подсистемы:
- Открываем «Терминал», вводим и отправляем на выполнение следующее указание:
wsl --set-default-version 2 - Чтобы впоследствии, после инсталляции дистрибутивов Linux проверить, какая версия WSL является установленной по умолчанию, используем такую команду:
wsl –status
Шаг 5: Скачивание и инсталляция дистрибутива Linux по выбору
После результативного прохождения рекомендованных выше четырёх этапов (или же выполнения инструкции «Способ 1» из этого материала) WSL2 в Windows 11 считается полностью подготовленной к выполнению своего предназначения. Это значит, что можно переходить к скачиванию и установке адаптированного для работы в рамках подсистемы дистрибутива Linux, — шагу, без которого интеграция и включение WSL2 по большому счёту является бессмысленной.
Вариант 1: Microsoft Store
Основной и наиболее удобный путь к получению пригодного для функционирования за счёт WSL 2 Linux-дистрибутива (или нескольких) – заключается в его загрузке и инсталляции из фирменного Магазина приложений от Microsoft.
Читайте также: Решение проблем с запуском Microsoft Store в Windows 11
- В Microsoft Store представлен целый ряд предназначенных для запуска в «Подсистеме Windows для Linux» дистрибутивов UNIX-операционки, а далее перечислены доступные на момент написания настоящей статьи прямые ссылки на их страницы в каталоге:
Ubuntu 18.04 LTS
Ubuntu 20.04 LTS
Ubuntu 22.04 LTS
openSUSE Leap 15.1
SUSE Linux Enterprise Server 12 SP5
SUSE Linux Enterprise Server 15 SP1
Kali Linux
Debian GNU/Linux
Fedora Remix for WSL
Pengwin
Pengwin Enterprise
Alpine WSL
Raft (пробная версия) - Выбираем дистрибутив из перечня выше, кликаем по соответствующей ему кнопке-ссылке, переходим на страницу продукта в Майкрософт Стор,
нажимаем на кнопку «Получить».
- Ожидаем завершения скачивания и развёртывания компонентов Linux-дистрибутива в Windows 11.
- Щёлкаем «Открыть» в окне Магазина Майкрософт,
после чего (при первом запуске инсталлированного дистрибутива Линукс) откроется окно консоли и необходимо будет подождать ещё какое-то время, пока файлы ОС распакуются и будут сохранённые в нужных папках на компьютере. (Последующие запуски Linux обычно занимают несколько мгновений).
- Когда в консоли появится приглашение «Enter new UNIX username»,
пишем имя пользователя дистрибутива Linux, нажимаем «Enter».
- Далее придумываем и дважды предоставляем системе пароль
для входа в Linux-учётку.
- На этом выбранный дистрибутив Linux считается полностью интегрированным в Windows 11, настроенным и готовым к эксплуатации.
(Впоследствии его запуск выполним одним из методов, предложенных в пункте №10 рекомендаций «Способ 1» из этого материала.)
Вариант 2: Пакеты APPX
В ситуациях, когда использовать Microsoft Store c целью получения адаптированных для работы в «Подсистеме Windows для Linux» дистрибутивов нет возможности или желания, можно пойти другим путём — скачать из сети и развернуть на компьютере APPX(AppxBundle)-пакет компонентов UNIX-операционки.
- Выбираем предполагаемый к установке в WSL 2 дистрибутив Linux в следующем списке, нажимаем на инициирующую его скачивание кнопку-ссылку:
Ubuntu
Ubuntu 22.04 LTS
Ubuntu 20.04
Ubuntu 18.04
Ubuntu 16.04
Debian GNU/Linux
Kali Linux
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 15 с пакетом обновления 2 (SP2)
SUSE Linux Enterprise Server 15 с пакетом обновления 3
openSUSE Tumbleweed
openSUSE Leap 15.3
openSUSE Leap 15.2
Oracle Linux 8.5
Oracle Linux 7.9
Fedora Remix for WSL - Загрузив APPX-пакет компонентов ОС Linux для WSL2 на диск компьютера, инсталлируем дистрибутив. При текущем подходе это возможно не единственным способом, выполняем один из двух следующих пунктов этой инструкции.
- Простейший (но не всегда доступный) способ установки Appx-пакетов:
- Переходим в содержащий Appx(AppxBundle)-файл каталог через Проводник Win 11.
- Немного ожидаем, затем кликаем «Установить» в окне запустившегося системного установщика пакетов.
- Вновь ждём, пока будут выполнены необходимые для развёртывания Appx манипуляции.
Дважды кликаем по значку пакета мышкой (или щёлкаем по нему правой кнопкой манипулятора и затем выбираем «Установить» в отобразившемся меню).
В результате автоматически откроется окно консоли Виндовс, где сначала завершится распаковка Linux-дистрибутива,
а затем осуществится его первый запуск.
- Другой вариант действий по развёртыванию полученного в виде APPX-файла дистрибутива Linux более сложен, но и более универсален (позволяет обойти многие, возможные к внедрению в Windows 11 ограничения):
- Открываем папку с APPX-файлом дистрибутива Linux в Проводнике Windows 11, кликаем по значку первого правой кнопкой мыши,
выбираем «Скопировать как путь» в открывшемся меню.
- Запускаем «Терминал» Win 11 от имени администратора.
- Пишем в консоли первую часть команды на развёртывание APPX-пакета в системе:
add-appxpackage - Вторая часть команды (через пробел) – это полный путь к инсталлируемому файлу. Его мы ранее скопировали в буфер обмена Виндовс 11, поэтому просто кликаем правой кнопкой манипулятора в окне «Терминала», что приведёт к вставке данных.
- Убедившись, что сформированная в консоли команда имеет аналогичный представленному на следующем скриншоте вид, нажатием «Enter» на клавиатуре запускаем её выполнение.
- Далее ожидаем заполнения индикатора «Ход выполнения операции развёртывания»
и отображения приглашения к вводу следующих команд в консоли, после чего её можно закрыть.
- Вызываем Главное меню Виндовс 11, перемещаемся в его раздел «Все приложения», и затем находим название установленного на шаге выше дистрибутива Linux, нажимаем на него.
- Далее вновь появится окно консоли, ждём окончания процедуры «Installing…».
Вводим назначаемое пользователю запускаемой ОС имя, затем дважды – пароль. После этого развёрнутый из APPX-файла дистрибутив Линукс считается предварительно настроенным и готовым к эксплуатации.
- Открываем папку с APPX-файлом дистрибутива Linux в Проводнике Windows 11, кликаем по значку первого правой кнопкой мыши,
Вариант 3: Средства WSL2
Скачивание и инсталляцию дистрибутивов ОС Linux в Windows 11 можно выполнить и задействовав исключительно предусмотренные в WSL2 средства. Правда, выбор доступных к получению таким образом программных продуктов может показаться ограниченным.
- Запускаем «Терминал» от имени Администратора.
- Получаем доступ к списку доступных дистрибутивов для скачивания и установки средствами WSL2 Linux-дистрибутивов. Для этого вводим и отправляем на выполнение такую команду:
wsl --list --online - Выбираем нужную ОС в полученном по результату выполнения предыдущего пункта инструкции перечне (далее необходимо будет точно ввести в консоль его наименование).
- Чтобы запустить процесс загрузки и затем инсталляции определённого дистрибутива Linux используется следующая команда:
wsl --install -d ИМЯ_ДИСТРИБУТИВА_LINUXВводим указание, заменив
ИМЯ_ДИСТРИБУТИВА_LINUXна наименование ОС из полученного ранее перечня (столбец «NAME»), нажимаем «Ввод» на клавиатуре ПК. - Далее просто ждём,
по окончании скачивания и установки запустится выбранная и теперь интегрированная в WSL 2 операционная система.
Напоследок отметим, что перечень возможных к запуску в Win 11 через WSL2 дистрибутивов Linux не ограничивается представленными выше в описаниях методов их установки. Практически любые, отсутствующие среди предлагаемых рассмотренной подсистемой по умолчанию, варианты Linux запустить возможно, но для этого потребуется выполнить импорт дистрибутива или сформировать (адаптировать для использования в WSL2) его собственноручно. Такой подход несколько выходит за рамки темы этой статьи и поэтому в ней не описан, при необходимости действуем по инструкциям с интернет-ресурса Microsoft Learn:
Импорт любого дистрибутива Linux для использования с WSL
Создание пользовательского дистрибутива Linux для WSL
Наша группа в TelegramПолезные советы и помощь