Windows Subsystem for Linux Installation Guide for Windows 10

There are two options available for installing Windows Subsystem for Linux (WSL):

Simplified install (preview release): wsl —install

The wsl —install simplified install command requires that you join the Windows Insiders Program and install a preview build of Windows 10 (OS build 20262 or higher), but eliminates the need to follow the manual install steps. All you need to do is open a command window with administrator privileges and run wsl —install , after a restart you will be ready to use WSL.

Manual install: Follow the six steps listed below.

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.

Simplified Installation for Windows Insiders

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.

In order to use the wsl —install simplified install command, you must:

• Join the Windows Insiders Program
• Install a preview build of Windows 10 (OS build 20262 or higher).
• Open a command line windows with Administrator privileges

Once those requirements are met, to install WSL:

• Enter this command in the command line you’ve opened in Admin mode: wsl.exe —install
• Restart your machine

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.

CONGRATULATIONS! You’ve successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

The —install command performs the following actions:

• Enables the optional WSL and Virtual Machine Platform components
• Downloads and installs the latest Linux kernel
• Sets WSL 2 as the default
• Downloads and installs a Linux distribution (reboot may be required)

By default, the installed Linux distribution will be Ubuntu. This can be changed using wsl —install -d . (Replacing with the name of your desired distribution.) Additional Linux distributions may be added to your machine after the initial install using the wsl —install -d command.

To see a list of available Linux distributions, enter wsl —list —online .

Manual Installation Steps

If you are not on a Windows Insiders build, the features required for WSL will need to be enabled manually following the steps below.

Step 1 — Enable the Windows Subsystem for Linux

You must first enable the «Windows Subsystem for Linux» optional feature before installing any Linux distributions on Windows.

Open PowerShell as Administrator and run:

We recommend now moving on to step #2, updating to WSL 2, but if you wish to only install WSL 1, you can now restart your machine and move on to Step 6 — Install your Linux distribution of choice. To update to WSL 2, wait to restart your machine and move on to the next step.

Step 2 — Check requirements for running WSL 2

To update to WSL 2, you must be running Windows 10.

• For x64 systems: Version 1903 or higher, with Build 18362 or higher.
• For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.
• Builds lower than 18362 do not support WSL 2. Use the Windows Update Assistant to update your version of Windows.

To check your version and build number, select Windows logo key + R, type winver, select OK. Update to the latest Windows version in the Settings menu.

If you are running Windows 10 version 1903 or 1909, open «Settings» from your Windows menu, navigate to «Update & Security» and select «Check for Updates». Your Build number must be 18362.1049+ or 18363.1049+, with the minor build # over .1049. Read more: WSL 2 Support is coming to Windows 10 Versions 1903 and 1909. See the troubleshooting instructions.

Step 3 — Enable Virtual Machine feature

Before installing WSL 2, you must enable the Virtual Machine Platform optional feature. Your machine will require virtualization capabilities to use this feature.

Open PowerShell as Administrator and run:

Restart your machine to complete the WSL install and update to WSL 2.

Step 4 — Download the Linux kernel update package

Download the latest package:

If you’re using an ARM64 machine, please download the ARM64 package instead. If you’re not sure what kind of machine you have, open Command Prompt or PowerShell and enter: systeminfo | find «System Type» . Caveat: On non-English Windows versions, you might have to modify the search text, for example, in German it would be systeminfo | find «Systemtyp» .

Run the update package downloaded in the previous step. (Double-click to run — you will be prompted for elevated permissions, select ‘yes’ to approve this installation.)

Once the installation is complete, move on to the next step — setting WSL 2 as your default version when installing new Linux distributions. (Skip this step if you want your new Linux installs to be set to WSL 1).

Step 5 — Set WSL 2 as your default version

Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:

Step 6 — Install your Linux distribution of choice

Open the Microsoft Store and select your favorite Linux distribution.

The following links will open the Microsoft store page for each distribution:

From the distribution’s page, select «Get».

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.

CONGRATULATIONS! You’ve successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

Install Windows Terminal (optional)

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.

Set your distribution version to WSL 1 or WSL 2

You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18362 or higher): wsl -l -v

To set a distribution to be backed by either version of WSL please run:

Make sure to replace with the actual name of your distribution and with the number ‘1’ or ‘2’. You can change back to WSL 1 at anytime by running the same command as above but replacing the ‘2’ with a ‘1’.

The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. 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.

If wsl —set-default-version results as an invalid command, enter wsl —help . If the —set-default-version is not listed, it means that your OS doesn’t support it and you need to update to version 1903, Build 18362 or higher. If you are on Build 19041 for ARM64, this command may fail when using PowerShell in which case you can use a Command Prompt instead to issue the wsl.exe command.

If you see this message after running the command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel . You still need to install the MSI Linux kernel update package.

Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

This will set the version of any new distribution installed to WSL 2.

Troubleshooting installation

Below are related errors and suggested fixes. Refer to the WSL troubleshooting page for other common errors and their solutions.

Installation failed with error 0x80070003

• The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Make sure that distributions are stored on your system drive:
• Open Settings -> **System —>Storage ->More Storage Settings: Change where new content is saved

WslRegisterDistribution failed with error 0x8007019e

• The Windows Subsystem for Linux optional component is not enabled:
• Open Control Panel ->Programs and Features ->Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.

Installation failed with error 0x80070003 or error 0x80370102

• Please make sure that virtualization is enabled inside of your computer’s BIOS. The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
• WSL2 requires that your CPU supports the Second Level Address Translation (SLAT) feature, which was introduced in Intel Nehalem processors (Intel Core 1st Generation) and AMD Opteron. Older CPUs (such as the Intel Core 2 Duo) will not be able to run WSL2, even if the Virtual Machine Platform is successfully installed.

Error when trying to upgrade: Invalid command line option: wsl —set-version Ubuntu 2

• Enure that you have the Windows Subsystem for Linux enabled, and that you’re using Windows Build version 18362 or higher. To enable WSL run this command in a PowerShell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux .

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.

• Deselect “Compress contents” (as well as “Encrypt contents” if that’s checked) by opening the profile folder for your Linux distribution. It should be located in a folder on your Windows file system, something like: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited.
• In this Linux distro profile, there should be a LocalState folder. Right-click this folder to display a menu of options. Select Properties > Advanced and then ensure that the “Compress contents to save disk space” and “Encrypt contents to secure data” checkboxes are unselected (not checked). If you are asked whether to apply this to just to the current folder or to all subfolders and files, select “just this folder” because you are only clearing the compress flag. After this, the wsl —set-version command should work.

In my case, the LocalState folder for my Ubuntu 18.04 distribution was located at C:\Users \AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

Check WSL Docs GitHub thread #4103 where this issue is being tracked for updated information.

The term ‘wsl’ is not recognized as the name of a cmdlet, function, script file, or operable program.

• Ensure that the Windows Subsystem for Linux Optional Component is installed. Additionally, if you are using an ARM64 device and running this command from PowerShell, you will receive this error. Instead run wsl.exe from PowerShell Core, or Command Prompt.

Error: This update only applies to machines with the Windows Subsystem for Linux.

• To install the Linux kernel update MSI package, WSL is required and should be enabled first. If it fails, it you will see the message: This update only applies to machines with the Windows Subsystem for Linux .
• There are three possible reason you see this message:

You are still in old version of Windows which doesn’t support WSL 2. See step #2 for version requirements and links to update.

WSL is not enabled. 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.

Error: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel .

• If the Linux kernel package is missing in the %SystemRoot%\system32\lxss\tools folder, you will encounter this error. Resolve it by installing the Linux kernel update MSI package in step #4 of these installation instructions. You may need to uninstall the MSI from ‘Add or Remove Programs’, and install it again.

—>

Установка Linux Mint «рядом» с Windows 10 (без потери данных!). Пошаговая инструкция для начинающих

Доброго времени суток!

Если вы никогда не пользовались Linux, но периодически о ней слышали что-нибудь хорошее, и загорелись желанием ее попробовать — то эта заметка для вас! ⚡

Что я буду здесь делать : установлю Linux на диск, на котором уже имеется Windows 10 (разумеется, без потери и удаления данных с него). И само собой будет сделано так, чтобы при включении компьютера была возможность выбирать нужную ОС. Заранее предупрежу, что это всё «не сложно», и на всё про всё потребуется мин. 15-20 времени (на современном ПК).

Примечание : чтобы с диска ничего не пропало — необходимо повторить все мои шаги в аналогичном порядке (без импровизации 😉). Если вы не уверены в своих силах — сделайте бэкап важных данных.



Пошаговая установка Linux Mint

ШАГ 1: загрузка установочного ISO с Linux Mint

Наверное, многие уже слышали, что версий Linux на самом деле много. В сегодняшней заметке я остановлюсь на Linux Mint . Почему?



Linux Mint (20.1) — рабочий стол (что будет видно сразу после загрузки ОС)

1. эта ОС работает сразу же «из коробки» — в наличии есть все самое нужное: мультимедиа программы, офис, браузер, почтовый клиент и т.д.;
2. она достаточно популярна и к ней много инструкций в сети;
3. интерфейс ее графич. оболочки очень напоминает Windows (привыкание происходит быстро 😉);
4. низкие системные требования: x64-процессор, ОЗУ 1 ГБ (я рекомендую не менее 4 ГБ!) ; 20 ГБ на диске;
5. безопасна и надежна.

Загрузить Linux Mint можно по следующей ссылке: 👇

Примечание : обратите внимание, что на сайте доступны три версии: Cinnamon, Mate, Xfce. В своем примере я буду использовать версию Cinnamon (Xfce — более «легкое» издание, рекомендуется для слабых машин).



Выбираем версию «Корица» для начала. // Cinnamon

Загружать, кстати, лучше с помощью торрент-раздачи ( в помощь : программы для загрузки торрентов).



Загрузка ISO-образа через торрент

ШАГ 2: создание установочной флешки

Будем считать, что установочный ISO-образ с Linux Mint у нас есть (загружен с офиц. сайта, ссылка была выше ☝).

Теперь нам нужно правильно записать ISO на флешку, чтобы не возникло вопросов при установке.

Рассмотрю, как это максимально просто сделать в Windows:

1. сначала загрузите программу 👉 Ventoy (эта утилита для быстрого создания загрузочных флешек);
2. затем подключите флешку к USB-порту и запустите Ventoy;
3. в настройках утилиты укажите разметку «GPT» и «Secure Boot Support» (на современных ПК/ноутбуках это будет так*). Нажмите «Install» (флешка будет спец. образом отформатирована/подготовлена — все данные на ней будут удалены!) ;



Ventoy — подготовка флешки

далее просто скопируйте ISO-образ Linux Mint на флешку (не извлекая!). Можно нажать по ПКМ по ISO-файлу и выбрать «Отправить на Ventoy» прямо в проводнике (см. пример ниже 👇).



Отправить файл ISO на флешку (Ventoy)

ШАГ 3: подготовка диска под новую ОС

Теперь к главному.

Я буду исходить из того, что на вашем ПК есть один диск, на котором и установлена текущая ОС Windows 10. Также на этом диске есть свободное место, не менее 50-60 ГБ!

И чтобы нам ничего не удалить с этого диска — необходимо спец. образом подготовить под новую ОС место.

Для этого понадобиться 👉 программа «Управление дисками» (нажмите Win+R, и используйте команду diskmgmt.msc. Эта утилита встроена в Windows).

После ее запуска, нажмите правой кнопкой мыши (ПКМ) по тому «C:» (на котором и установлена Windows) — и выберите опцию «Сжать том». См. внимательно скрин ниже. 👇



Сжимаем системный раздел с Windows (на нем много свободного места)

Далее укажите размер сжимаемого пространство (т.е. это место на диске мы выделим под новую ОС Linux Mint). В моем примере ∼50 ГБ (50 000 МБ). 👇

Выделять меньше — не рекомендую (т.к. останется мало места под установку доп. приложений и файлов в самой Linux — вы же с ней планируете поработать? 😉) .



50000 МБ примерно равно 50 ГБ — этого хватит под Linux Mint

После вы должны увидеть, что на диске, помимо тома «C:» с Windows, появилось не распределенное место — размером 48,83 ГБ (запомните эти цифры — они будут нужны при установке Linux). 👇

Больше в » Управление дисками» ничего делать не нужно — утилиту можно закрыть и двигаться дальше!



Раздел под Linux создан (не распределен!)

ШАГ 4: запуск установки (начало)

Выключаем ПК/ноутбук, подключаем к USB-порту нашу подготовленную флешку, и загружаемся с нее через Boot Menu (/настройки BIOS). Если вы не знаете как это сделать — см. ссылочку ниже в помощь!

👉 Кстати, обратите внимание, что, если в загрузочном меню (Boot Menu)) у вас будет отображаться 2 строчки с флешкой — выбирайте строку с аббревиатурой UEFI!



Загрузка с подготовленной флешки в Ventoy

Если вы создавали установочную флешку с помощью Ventoy (как я рекомендовал выше) — перед вами появиться меню с предложением выбрать нужный ISO-образ (в моем случае их несколько — разумеется, указываю Linux Mint и жму Enter. ).



Выбор образа (данное меню будет, если вы подготовили флешку с помощью утилиты Ventoy)

Далее перед вами появиться меню с предложением выбрать вариант загрузки. Для нашего случая выбирать нужно первый — «Start Linux Mint. «. 👇



Start Linux Mint (первая строка)

Через 1-2 мин. перед вами появиться рабочий стол — уже можно начинать знакомиться Linux Mint! 😉

Для начала установки — нажмите по значку «Install Linux Mint» (он будет на рабочем столе).



Install Linux Mint

Затем выберите язык, раскладку клавиатуры (см. пару скринов ниже 👇).



Есть поддержка русского — его и выбираем!



Настройку беспроводной сети на данным этапе можно пропустить (чтобы не тратить время).



Подключение к Wi-Fi можно пропустить

На установку кодеков можно согласиться.



Если появится сообщение насчет смонтированных разделов — нажмите «Нет». 👇



Нет (насчет монтирования)

После этого должно появиться окно «Тип установки»! ⚡ Это важный момент, т.к. именно от него будет зависеть что будет с данными на вашем диске. Я вынес его в отдельный шаг, см. ниже.



Тип установки — другой вариант

ШАГ 5: разбивка диска (ключевой момент ⚡)

Linux Mint на выбор предлагает несколько типов установки.

Я рекомендую выбрать 👉 «Другой вариант» и вручную самостоятельно всё указать (первые два типа установки в ряде случаев могут «затереть» вашу текущую ОС и данные).

Важно: ничего сложного здесь не будет, но имейте ввиду, что от некорректно-введенных значений (действий) можно легко удалить всю информацию на диске!



Тип установки — другой вариант

И так, на следующем этапе установщик представит вашему взору довольно много различных томов. Среди них нам нужно найти тот, который мы заранее подготовили под Linux (в шаге 3). В моем случае он был равен 50 ГБ!

Находим это свободное место, выделяем его и нажимаем на «плюсик», см. скриншот ниже. 👇



Свободное место — нажимаем на плюсик

Далее создаем раздел со следующими параметрами:

• размер: 512 МБ ;
• тип нового раздела: первичный ;
• местоположение нового раздела: начало этого пространства ;
• использовать как: системный раздел EFI . 👇



Создаем системный раздел EFI

Теперь снова находим «наше свободное место» (от которого уже мы отняли 512 МБ) , выделяем его и нажимаем на «плюсик».



Свободное место — снова на плюсик

Далее создаем корневой раздел с параметрами:

• размер: 15 ГБ (или более) ;
• тип нового раздела: первичный ;
• местоположение нового раздела: начало этого пространства ;
• использовать как: журналируемая файловая система Ext4 ;
• 👉 точка монтирования: /

Всё нужное я выделил желтым цветом. 👇

Прим. : на этот раздел и будет установлена система!



Создание корневого раздела

Снова находим «наше» оставшееся свободное место — в моем случае

35 ГБ (т.к. 50 ГБ — 512 МБ — 15 ГБ) , выделяем его и нажимаем на «плюсик».



Создание домашнего раздела

• размер: не трогаем (сколько осталось — столько осталось. В моем случае около 35 ГБ);
• тип нового раздела: первичный ;
• местоположение нового раздела: начало этого пространства ;
• использовать как: журналируемая файловая система Ext4 ;
• 👉 точка монтирования: /home

Прим. : на этом разделе будет храниться все пользовательские данные (фильмы, картинки и т.д.). При последующей переустановке ОС — этот раздел можно оставить не тронутым, что очень удобно. 👌



Создание домашнего раздела — 2

После «этих» приготовлений можно нажать кнопочку «Установить сейчас» . См. пример ниже. 👇

👉 Обратите внимание — в самом низу окна указан диск, на который будет установлен загрузчик GRUB (в моем случае: «ATA CT480BX500. «). Указывается не определенный раздел, а диск целиком! Т.к. в нашем примере Linux устанавливается на единственный диск с Windows — на этом можно не заострять внимание.

Однако, если у вас несколько дисков в системе — необходимо выбрать тот, который идет первый в списке загрузок в BIOS (т.е. обычно тот, на котором стоит текущая Windows).



👉 Обратите внимание, что установщик нас уведомляет о том, что создано три новых раздела и на них будет записана информация. Осталось только согласиться и нажать «Продолжить» .



Записать изменения на диск

Далее потребуется указать свой часовой пояс (здесь ничего сложного 😉).



Где вы находитесь

В следующем шаге задается имя администратора и пароль (рекомендую использовать латиницу! С русскими символами в дальнейшем могут возникнуть вопросы. ).



Имя администратора и пароль

После дожидаемся конца установки. Как правило, копирование файлов происходит достаточно быстро: 5-10 мин.



Установка Linux Mint

ШАГ 6: завершение установки (пару слов о первых настройках)

По завершению копирования всех файлов на диск — вы увидите сообщение, что установка завершена и требуется перезагрузка компьютера.

На этом этапе можно отключить загрузочную флешку от USB-порта, и согласиться с перезагрузкой. 👇



Установка завершена — перезагрузить

После перезагрузки у вас должно появиться окно с предложением выбрать ОС: будет доступна и только что установленная Linux Mint, и «старая» Windows. Разумеется, пока мы выбираем первый вариант. 👌



Выбор ОС при включении ПК

В общем-то, после этого перед вами появиться обычный рабочий стол с приветствием от разработчиков ОС. 👇



Добро пожаловать в Linux Mint

Пользоваться системой относительно не сложно — интерфейс очень напоминает классический от Windows. Открыв меню ПУСК — можно найти несколько десятков самых популярных программ для всех типовых задач: веб-браузер, проигрыватель медиа-файлов, текстовый редактор, и т.д. 👇



Такой же рабочий стол и меню ПУСК как в Windows 10

Настройка параметров (экрана, Wi-Fi подкл. и пр.)

Пожалуй, это первое, с чем возникают вопросы. Поэтому пару слов ниже.

Что касается подключения к сети Интернет — то обычно в Linux Mint все драйвера устанавливаются автоматически (в т.ч. и на сетевой адаптер).

Например, чтобы подключиться к Wi-Fi — вам будет достаточно кликнуть мышкой по значку сети рядом с часами (справа, внизу), выбрать нужную сеть и ввести пароль. 👇

Т.е. всё также, как в Windows — почти никаких отличий. 😉



Подключиться к беспроводной сети

Что касается разрешения, масштабирования и пр. настроек экрана.

Нажмите по меню ПУСК, и откройте параметры системы (Центр управления). 👇



Параметры системы — Центр управления // Linux Mint

В открывшемся окне будут представлены сотни параметров, которые можно изменить: шрифты, темы, фоновые рисунки, эффекты, автозагрузка, дата и время и т.д. См. пример ниже. 👇



Параметры системы — Linux Mint

Если речь идет о настройке изображения — то нам понадобиться вкладка «Оборудование / экран» .



Экран — параметры ОС

Далее вручную можно указать разрешение, частоту обновления, масштабирование и пр. параметры. 👇 Теперь изображение должно стать комфортным!



Разрешение, частота обновления, масштабирование и пр.

Установка приложений

Что касается установки приложений (программ) — то здесь всё тоже достаточно просто. (и для этого совсем не обязательно лезть в командную строку).

Допустим вам понадобился новый видеопроигрыватель. 😉

Сначала нужно открыть меню ПУСК и перейти в раздел «Менеджер программ» .



После открыть нужную категорию ( прим. : все самые популярные приложения вынесены отдельно, и отображаются сверху).



Большой список программ

Из списка аудио- и видео- приложений выбираем нужное и жмем кнопочку «Установить» . Linux Mint в целях безопасности попросит ввести пароль администратора (который мы задавали при инсталляции ОС), а после произведет установку приложения.



Выбираем нужное приложение и нажимаем кнопку установки!

Значок (ярлык) для запуска приложения появится в меню ПУСК.

ШАГ 7: как выбирать, какую систему загружать — Windows или Linux

Если вы всё сделали как в моем примере выше — то перед каждым включением компьютера у вас на неск. секунд будет появляться меню GRUB с предложением выбрать ОС.

Для загрузки Windows (например) выберите стрелочками пункт «Windows Boot Manager. « и нажмите Enter.



Выбор ОС при включении ПК

Если вдруг данное меню не появляется и автоматически начинает загружаться Linux (или Windows), а вам нужна другая ОС — зайдите 👉 в Boot Menu и вручную укажите какая система вам требуется.



Boot Menu — выбор ОС

PS

Кстати, многие другие дистрибутивы Linux устанавливаются аналогично (по крайней мере, основанные на Ubuntu).

Дополнения по теме, — разумеется, приветствуются!