Contribute to this page
Toggle table of contents sidebar
What you will learn¶
-
How to enable and install WSL on Windows 10 and Windows 11
-
How to install
Ubuntu 24.04 LTS
using the Microsoft Store or WSL commands in the terminal
What you will need¶
-
Windows 10 or 11 running on either a physical device or virtual machine
-
All of the latest Windows updates installed
Install WSL¶
You can install WSL from the command line. Open a PowerShell prompt as an Administrator (we recommend using Windows Terminal) and run:
It is recommended to reboot your machine after this initial installation to complete the setup.
Install Ubuntu WSL¶
There are multiple ways of installing distros on WSL, here we focus on two: the Microsoft Store application and WSL commands run in the terminal. The result is the same regardless of the method.
Method 1: Microsoft Store application¶
Find the distribution you prefer on the Microsoft Store and then click Get.
Ubuntu will then be installed on your machine. Once installed, you can either launch the application directly from the Microsoft Store or search for Ubuntu in your Windows search bar.
Method 2: WSL commands in the terminal¶
In a PowerShell terminal, you can run wsl --list --online
to see an output with all available distros and versions:
The following is a list of valid distributions that can be installed. The default distribution is denoted by '*'. Install using 'wsl --install -d <Distro>'. NAME FRIENDLY NAME * Ubuntu Ubuntu Debian Debian GNU/Linux kali-linux Kali Linux Rolling Ubuntu-18.04 Ubuntu 18.04 LTS Ubuntu-20.04 Ubuntu 20.04 LTS Ubuntu-22.04 Ubuntu 22.04 LTS Ubuntu-24.04 Ubuntu 24.04 LTS ...
Your list may be different once new distributions become available.
You can install a version using a NAME from the output:
> wsl --install -d Ubuntu-24.04
You’ll see an indicator of the installation progress in the terminal:
Installing: Ubuntu 24.04 LTS [==========================72,0%========== ]
Use wsl -l -v
to see all your currently installed distros and the version of WSL that they are using:
NAME STATE VERSION Ubuntu-20.04 Stopped 2 * Ubuntu-24.04 Stopped 2
Note on installing images without the Microsoft Store¶
If you do not have access to the Microsoft Store or need to install
a custom image it is possible to import a distribution as a tar file:
> wsl --import <DistroName> <InstallLocation> <InstallTarFile>
Appx and MSIX packages for a given distro can also be downloaded and installed.
Please refer to Microsoft’s documentation for more detailed information on these installation methods:
-
Importing Linux distributions
-
Installing distributions without the Microsoft Store
Warning
You should always try to use the latest LTS release of Ubuntu, as it offers the best security, reliability and support when using Ubuntu WSL.
Currently we do not have a recommended location from which to download tar and Appx/MSIX files for Ubuntu distros.
Run and configure Ubuntu¶
To open an Ubuntu 24.04 terminal run the following command in PowerShell:
Once it has finished its initial setup, you will be prompted to create a username and password. They don’t need to match your Windows user credentials.
Finally, it’s always good practice to install the latest updates by running the following commands within the Ubuntu terminal, entering your password when prompted:
$ sudo apt update $ sudo apt full-upgrade -y
Enjoy Ubuntu on WSL¶
In this guide, we’ve shown you how to install Ubuntu WSL on Windows 10 or 11.
We hope you enjoy working with Ubuntu in WSL. Don’t forget to check out our blog for the latest news on all things Ubuntu.
Further Reading¶
-
Setting up WSL for Data Science
-
Whitepaper: Ubuntu WSL for Data Scientists
-
Microsoft WSL Documentation
-
Ask Ubuntu
Материал написан пользователем сайта.
В этой статье мы рассмотрим как установить и настроить WSL. Установим с его помощью дистрибутивы Линукс из терминала PoweShell и магазина приложений Microsoft Store. Рассмотрим несколько опций использования утилиты WSL.
Будем пользоваться Windows 10 Pro, но и для Windows 11 все должно работать точно так же.
WSL (Windows Subsystem for Linux) — функция операционной системы Microsoft Windows, которая позволяет разработчикам запускать среду Linux без необходимости использования отдельной виртуальной машины или двойной загрузки.
WSL позволяет использовать утилиты командной строки Linux в среде Windows. Также WSL может быть полезна новичкам в мире Linux, которые не могут использовать полноценную виртуальную машину в силу недостаточных характеристик компьютера, а ставить полноценный дистрибутив Linux еще не готовы.
Установка и настройка WSL
Для того, чтобы компоненты WSL могли работать на компьютере, необходимо убедиться в том, что в настройках BIOS включена поддержка аппаратной виртуализации.
Во время загрузки компьютера с помощью клавиши, определенной производителем (обычно одна из следующих: «Esc«, «Del«, «F2«, «F9«, «F10«), заходим в настройки BIOS.
Данный пункт настроек может иметь следующее наименование и располагаться в разделе:
System Configuration -> Virtualization Technology -> Enabled
Или, например:
Advanced -> Virtualization Technology -> Enabled
После того, как поддержка аппаратной виртуализации активирована, запускам ОС Windows. Поставим «галочки» в соответствующем разделе Панели управления Windows, чтобы активировать WSL.
Пуск -> Служебные - Windows -> Панель управления -> Программы ->
-> Включение или отключение компонентов Windows -> Подсистема Windows для Linux
Пуск -> Служебные - Windows -> Панель управления -> Программы ->
-> Включение или отключение компонентов Windows -> Платформа виртуальной машины
После этого Windows загрузит необходимые компоненты и попросит перезагрузить компьютер. Перезагружаем компьютер.
Открываем окно терминала PowerShell. Чтобы открыть PowerShell, зажимаем Shift + ПКМ (правая кнопка мыши) в свободной области Рабочего стола и выбираем в появившемся контекстном меню «Открыть окно PoweShell здесь«.
Вводим в окно PowerShell следующие команды.
Данная команда установит в качестве основной вторую версию WSL — WSL2. Поскольку первая версия WSL была признана Microsoft неудачной и больше не поддерживается.
wsl --set-default-version 2
Следующая команда скачает и установит требуемые для корректной работы компоненты WSL:
wsl --update
После этого Подсистема Windows для Linux на компьютере готова к работе.
Установка дистрибутивов Linux из командной строки PowerShell
Для того, чтобы посмотреть список официально поддерживаемых WSL и готовых к загрузке дистрибутивов Linux, вводим в терминал PowerShell команду:
wsl --list --online
Список дистрибутивов в моем случае выглядит следующим образом:
PS C:\Users\UlyssesJJ> wsl --list --online
Ниже приведен список допустимых дистрибутивов, которые можно установить.
Для установки воспользуйтесь командой "wsl.exe --install <Distro>".
NAME FRIENDLY NAME
Ubuntu Ubuntu
Debian Debian GNU/Linux
kali-linux Kali Linux Rolling
Ubuntu-18.04 Ubuntu 18.04 LTS
Ubuntu-20.04 Ubuntu 20.04 LTS
Ubuntu-22.04 Ubuntu 22.04 LTS
Ubuntu-24.04 Ubuntu 24.04 LTS
OracleLinux_7_9 Oracle Linux 7.9
OracleLinux_8_7 Oracle Linux 8.7
OracleLinux_9_1 Oracle Linux 9.1
openSUSE-Leap-15.5 openSUSE Leap 15.5
SUSE-Linux-Enterprise-Server-15-SP4 SUSE Linux Enterprise Server 15 SP4
SUSE-Linux-Enterprise-15-SP5 SUSE Linux Enterprise 15 SP5
openSUSE-Tumbleweed openSUSE Tumbleweed
Чтобы установить дистрибутив из списка, воспользуемся данной командой, где «debian» — название дистрибутива:
wsl --install -d debian
После чего будет скачан и установлен соответствующий дистрибутив. Во время установки будет предложено создать стандартного пользователя и придумать для него пароль.
Рабочий дистрибутив Linux внутри Windows готов к работе!
Установка дистрибутивов Linux из Microsoft Store
Другие дистрибутивы, доступные для установки, можно найти в официальном магазине приложений Windows — Microsoft Store.
Установка таких дистрибутивов не отличается от установки официально поддерживаемых.
Продемонстрируем это на примере дистрибутива Alpine Linux.
В поисковой строке Microsoft Store пишем «Alpine WSL«, после чего скачиваем соответствующее приложение.
После завершения загрузки и установки открываем появившийся ярлык:
Пуск -> Все приложения -> Alpine Linux
Открывается терминал. Создаем стандартного пользователя и придумываем для него пароль.
Проводим специфичные для Alpine первичные настройки — меняем права доступа к корневым директориям (нерекурсивно):
su - c "chmod 755 /"
Дистрибутив Alpine Linux полностью готов к работе!
Утилита WSL
В терминале PowerShell утилита WSL поддерживает множество аргументов для управления дистрибутивами.
Например, завершить работу всех дистрибутивов на компьютере можно командой:
wsl --shutdown
А поменять пароль суперпользователя, если первоначальный забыли, так:
wsl --user root --distribution debian passwd
Удалить дистрибутив:
wsl --unregister debian
Больше информации об опция WSL:
wsl --help
Заключение
Как было продемонстрировано выше, установка и настройка WSL очень простая и не требует узкоспециализированных знаний. WSL подойдет уверенным пользователям Linux, которые время от времени пользуются ОС Windows и при этом не хотят терять богатства командной строки UNIX. Также WSL может быть полезен новичкам, которые хотят попробовать Linux, но пока что не готовы установить полноценный дистрибутив Linux в силу каких-либо причин.
Среда 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

Если вы только начали свой путь разработчика и до сих используете операционную систему семейства Microsoft Windows, то уже наверняка столкнулись с ситуацией, когда ваш инструментарий отличается от того, что установлено у большинства людей из этой профессии. Чаще всего проблемы начинаются при работе в командной строке. Дело в том, что Windows не является POSIX-совместимой операционной системой, поэтому в ней отсутствует базовый набор прикладных программ, который необходим для разработки.
- Ubuntu из Microsoft Store
- Другие способы
Несмотря на все написанное дальше, наша основная рекомендация — ставить полноценный Linux-дистрибутив, например, Ubuntu и полностью погружаться в него. Подавляющее большинство веб-проектов работает под управлением Linux-систем. А постоянное использование такой системы на домашнем и рабочем компьютере равносильно погружению в языковую среду при изучении иностранных языков.
Для новичков есть способ проще и быстрее — технологии виртуализации. Об этом и поговорим.
Ubuntu из Microsoft Store
Если вы работаете на Windows версии не ниже 10 с архитектурой x64, то можно воспользоваться встроенным решением и установить слой совместимости (Windows Subsystem for Linux), а затем дистрибутив на основе Ubuntu Linux через магазин приложений Microsoft Store.
Подсистема WSL поставляется вместе с Windows, но не включена по-умолчанию. Чтобы её активировать, необходимо открыть PowerShell и ввести команду:
wsl --install
Также эта команда скачивает и устанавливает дистрибутив Ubuntu Linux. Скорее всего после завершения установки потребуется перезагрузить компьютер.
После перезагрузки найдите в меню Пуск приложение Ubuntu и запустите его.
Первый запуск может вызвать ошибку Error: 0x8007007e
и предложение прочитать инструкцию по её решению https://aka.ms/wslinstall. Если хотите сэкономить время, то просто запустите PowerShell
(не путать с cmd
) от имени администратора и выполните следующую команду:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
После этого компьютер попросит перегрузиться, а потом нужно снова запустить приложение Ubuntu. В случае удачной установки откроется интерпретатор командной строки с предложением ввести имя пользователя и пароль. Выглядеть это будет вот так:
Installing, this may take a few minutes...
Installation successful!
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username:
Данные логин и пароль никак не связаны с вашим пользователем в Windows, придумайте новые и не забывайте их. Чтобы изменить пароль Ubuntu в будущем, вам пригодится команда passwd
Обратите внимание на данные официальные инструкции от Microsoft, где рассмотрены не только установка и настройка WSL и Ubuntu, но так же рассказано о настройке окружения для разработки (VSCode, Git)
- Настройка среды разработки WSL
- WSL + VSCode
Другие способы
Если у вас нет возможности установить WSL, то можно использовать другие способы виртуализации для установки Linux. Смотрите другие наши гайды:
- VirtualBox
- Vagrant
Install Linux Ubuntu on Windows using WSL
Certain tasks, such as
Contribute Ceremony
orContract Deployments
, sometimes don’t require a cloud server (VPS). Instead, installing a Linux distribution like Ubuntu on Windows can be sufficientIn this Guide, I’ll tell you how to Install Linux (Ubuntu distribution) on Windows using WSL
Step 1: Enable WSL
-
Opening Windows Powershell Terminal
-
Run the WSL Installation Command:
- It may ask you to choose a username and password
- Restart Your Computer:
After the installation completes, you may need to restart your computer
Step 2: Install Ubuntu
- Open Microsoft Store:
After restarting, open the Microsoft Store from the Start menu.
- Search for Ubuntu:
In the Store, type «Ubuntu» in the search bar. You’ll see various versions like Ubuntu 20.04 LTS, Ubuntu 22.04 LTS, etc
- Select and Install:
Click on the version you want to install, then click the Get or Install button
Step 3: Set Up Ubuntu
- Launch Ubuntu:
- Once installed, you can launch it directly from the Microsoft Store or by searching for «Ubuntu» in the Start menu
- The first time you launch Ubuntu, it will take a moment to set up. After that, you will be prompted to create a new
user
account and password
Step 4: Install and Update Packages (aka Drivers)
- Update and Upgrade default Packages
sudo apt update
sudo apt upgrade
- Install more important packages
sudo apt install curl iptables build-essential git wget lz4 jq make gcc nano automake autoconf tmux htop nvme-cli pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y
- Install Docker
sudo apt update -y && sudo apt upgrade -y
for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update -y && sudo apt upgrade -y
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# Docker version
docker --version
Optional: To install more packages you can check my recent Linux guide
Optional: Change user
There are 2 ways to login to ubuntu: 1. You are root
(administrator with full permissions), or 2. you are an specific user
with specific permissions
You see by entering whoami
, I am logged in as user:mirana
If you want to login with root (full permissions):
- Now you see I am as
root
user, but inmirana
user main directory - I need to type
cd
to move to the main directory ofroot
To login to a specific user again, Enter this command: su - username
Access Ubuntu directories in Windows explorer
To go to your Ubuntu directory using Windows explorer, Enter this in Windows Explorer Addressbar
home
: main directory of your specific userroot
: main directory of yourroot
user
If you don’t have access to root directory, Enter this command in terminal sudo chmod 755 /root