{"id":17106,"date":"2023-06-15T18:58:37","date_gmt":"2023-06-15T16:58:37","guid":{"rendered":"https:\/\/contabo.com\/blog\/?p=17106"},"modified":"2023-07-03T10:44:31","modified_gmt":"2023-07-03T08:44:31","slug":"how-to-install-wsl2-on-windows-10","status":"publish","type":"post","link":"https:\/\/contabo.com\/blog\/how-to-install-wsl2-on-windows-10\/","title":{"rendered":"Installing Windows Subsystem for Linux 2 on Microsoft Windows 10 [How-To Guide]"},"content":{"rendered":"\n
\"Installing<\/figure>\n\n\n\n
<\/div>\n\n\n\n

In 2021 Microsoft introduced Windows Subsystem for Linux (short: WSL). With that you can run a Linux environment directly on your Windows machine without the need for tools like VirtualBox or dual-boot setups. You can just start a Linux session of your choice directly with the push of a button and without the need to restart your PC or workstation. All this works because of the built-in virtualization software called \u201cHyper-V\u201d. If you want to learn more about virtualization and how it\u2019s done at Contabo, check out our Cloud Explained Series here. <\/p>\n\n\n\n

In this beginner-friendly tutorial we will guide you through the process of installing and enabling WSL on your local machine and installing Ubuntu 22.04 LTS. But don\u2019t worry: Other distributions of Linux are also available. We will give you a full overview of all available distros later in the article. <\/p>\n\n\n\n

But for now, let’s start with the prerequisites. <\/p>\n\n\n\n

Prerequisites<\/h2>\n\n\n\n

To follow this guide, make sure that your PC has Windows 10 Version 1903<\/strong> (or later) with Build 18362<\/strong> (or later). <\/p>\n\n\n\n

Enabling WSL on Your Machine<\/h3>\n\n\n\n

By default, WSL is deactivated on your PC or workstation. In this first step we are going to activate it using the command line. <\/p>\n\n\n\n

Open the Start menu by pressing the Windows-Key and search for \u201cPowerShell\u201d. Now right click on Windows PowerShell and click on \u201cRun as administrator\u201d.  <\/p>\n\n\n\n

\"Run<\/figure>\n\n\n\n

You may need to confirm this in a popup menu by clicking on \u201cYes\u201d <\/p>\n\n\n\n

Now enable WSL by pasting in the following command: <\/p>\n\n\n\n

dism.exe \/online \/enable-feature \/featurename:Microsoft-Windows-Subsystem-Linux \/all \/norestart <\/code><\/pre>\n\n\n\n
If everything worked, this will be the output: <\/p>\n\n\n\n
\"Enable<\/figure>\n\n\n\n
Enabling Virtual Machine Platform and WSL 2 on Windows<\/h3>\n\n\n\n
In order to run the latest version of WSL, which is WSL 2, you need to enable \u201cWindows Virtual Machine Platform\u201d.  <\/p>\n\n\n\n
To do so use this command: <\/p>\n\n\n\n
dism.exe \/online \/enable-feature \/featurename:VirtualMachinePlatform \/all \/norestart<\/code><\/pre>\n\n\n\n
The output will be similar to this: <\/p>\n\n\n\n
\"Enabling<\/figure>\n\n\n\n
For all the new changes and enabled features to take effect you need to restart your PC. <\/p>\n\n\n\n
Download the Linux Kernel Update Package<\/h3>\n\n\n\n
Now it is time to download and install the Linux kernel update package. <\/p>\n\n\n\n
If you for whatever reason want to click on the download link on the official Microsoft website, the download link can be found here<\/a>. <\/p>\n\n\n\n
Otherwise, the direct download can be found when clicking here<\/a>. <\/p>\n\n\n\n
After you\u2019ve downloaded the package, execute the file to start the installation and follow the instructions given in the Installation Wizard. <\/p>\n\n\n\n
\"Download<\/figure>\n\n\n\n
Set WSL 2 as default<\/h3>\n\n\n\n
Now it\u2019s time to set the newest version of WSL, namely WSL 2, as the default. This can be archived by opening another PowerShell terminal as administrator (as shown earlier) and executing the following command: <\/p>\n\n\n\n
wsl --set-default-version 2<\/code><\/pre>\n\n\n\n
The output will be like this: <\/p>\n\n\n\n
\"set<\/figure>\n\n\n\n
Installing a Linux Distribution of Your Choice Using WSL<\/h2>\n\n\n\n
Now that we have fully prepared our system and installed all the requirements, we can finally continue with the actual installation of a Linux subsystem on our local PC. <\/p>\n\n\n\n
Now it\u2019s your choice which distribution of Linux you want to install. Here is an overview of all Linux-distros that are supported by WSL 2 (and the way of installation) <\/p>\n\n\n\n
Linux Distribution <\/td>Installation via MS Store <\/td>Installation via CLI <\/td><\/tr>
Ubuntu 16.04 <\/td>No <\/td>Yes <\/td><\/tr>
Ubuntu 18.04 <\/td>No <\/td>Yes <\/td><\/tr>
Ubuntu 18.04 ARM <\/td>No <\/td>Yes <\/td><\/tr>
Ubuntu 18.04 LTS <\/td>Yes <\/td>No <\/td><\/tr>
Ubuntu 20.04 <\/td>No <\/td>Yes <\/td><\/tr>
Ubuntu 20.04 ARM <\/td>No <\/td>Yes <\/td><\/tr>
Ubuntu 20.04 LTS <\/td>Yes <\/td>No <\/td><\/tr>
Ubuntu 22.04 LTS <\/td>Yes <\/td>Yes <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Debian GNU\/Linux <\/td>Yes <\/td>Yes <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
openSUSE Leap 15.1 <\/td>Yes <\/td>No <\/td><\/tr>
OpenSUSE Leap 15.2 <\/td>No <\/td>Yes <\/td><\/tr>
OpenSUSE Leap 15.3 <\/td>No <\/td>Yes <\/td><\/tr>
OpenSUSE Tumbleweed <\/td>No <\/td> Yes<\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
SUSE Linux Enterprise Server 12 <\/td>No <\/td>Yes <\/td><\/tr>
SUSE Linux Enterprise Server 12 SP5 <\/td>Yes <\/td>No <\/td><\/tr>
SUSE Linux Enterprise Server 15 SP1 <\/td>Yes <\/td>No <\/td><\/tr>
SUSE Linux Enterprise Server 15 SP2 <\/td>No <\/td>Yes <\/td><\/tr>
SUSE Linux Enterprise Server 15 SP3 <\/td>No <\/td>Yes <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Kali Linux <\/td>Yes <\/td>Yes <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Fedora Remix for WSL <\/td>Yes <\/td>Yes <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Pengwin <\/td>Yes <\/td>No <\/td><\/tr>
Pengwin Enterprise <\/td>Yes <\/td>No <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Alpine WSL <\/td>Yes <\/td>No <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Raft (Free Trial) <\/td>Yes <\/td>No <\/td><\/tr>
 <\/td> <\/td> <\/td><\/tr>
Oracle Linux 7.9 <\/td>No <\/td>Yes <\/td><\/tr>
Oracle Linux 8.5 <\/td>No <\/td>Yes <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Once you\u2019ve chosen which Linux distribution you want to use, we can continue with the installation. <\/p>\n\n\n\n
Installation via the Microsoft Store<\/h3>\n\n\n\n
One of the two ways to install the most popular distributions is through the Microsoft Store. <\/p>\n\n\n\n
An overview of all the links which will lead to the corresponding Microsoft Store page can be found here: https:\/\/learn.microsoft.com\/en-us\/windows\/wsl\/install-manual#step-6—install-your-linux-distribution-of-choice<\/a> <\/p>\n\n\n\n
Once you find the fitting Distro for you, just click on the link and the MS Store page will open. <\/p>\n\n\n\n
\"install<\/figure>\n\n\n\n
To install Ubuntu 22.04.02 LTS just click on \u201cGet\u201d and wait until the installation has finished. <\/p>\n\n\n\n
Now click on \u201cOpen\u201d. <\/p>\n\n\n\n
After a few seconds of installation, you will be prompted to create an account for your Ubuntu instance: <\/p>\n\n\n\n
\"create<\/figure>\n\n\n\n
After choosing a username you will be prompted to create a password for this account. <\/p>\n\n\n\n
Congrats!<\/strong> Now your Ubuntu instance is set up and fully configured. <\/p>\n\n\n\n
Installation via Command Line Interface (CLI)<\/h3>\n\n\n\n
If the distribution you want to install isn\u2019t available via the Microsoft Store, you can install it using the command line. <\/p>\n\n\n\n
To do so, start another PowerShell as administrator. To get the link of the Linux distribution you want to install, check out Microsoft’s official Documentation here<\/a>. Make a right click on the Distro you want to install and click on \u201cCopy link address\u201d. <\/p>\n\n\n\n
The link for Debian would look like this: 
https:\/\/aka.ms\/wsl-debian-gnulinux<\/a> <\/p>\n\n\n\n
Now go back into the terminal and use the following command to download the Linux distribution you just chose: <\/p>\n\n\n\n
curl.exe -L -o ubuntu-2004.appx [link_to_your_linux_distro] <\/code><\/pre>\n\n\n\n
For our example, the command to download Debian would look like this: <\/p>\n\n\n\n
curl.exe -L -o ubuntu-2204.appx https:\/\/aka.ms\/wsl-debian-gnulinux<\/a>  <\/code><\/pre>\n\n\n\n
After the download has finished, add the Appx-Package with the following command: <\/p>\n\n\n\n
Add-AppxPackage .\\app_name.appx <\/code><\/pre>\n\n\n\n
For our example the command would look like this:  <\/p>\n\n\n\n
Add-AppxPackage .\\debian.appx<\/code><\/pre>\n\n\n\n
Now go the the folder where you downloaded this Distro to and double-click on it to install it. <\/p>\n\n\n\n
Now click on \u201cInstall\u201d <\/p>\n\n\n\n
\"Install<\/figure>\n\n\n\n
After the installation hit \u201cLaunch\u201d <\/p>\n\n\n\n
After a short installation phase, you will be prompted to create an account for your Debian instance: <\/p>\n\n\n\n
\"create<\/figure>\n\n\n\n
After choosing a username you will be prompted to create a password for this account. <\/p>\n\n\n\n
Congrats! <\/strong>Now your Debian instance is set up and fully configured. <\/p>\n\n\n\n
For more Linux- & Windows-related tutorials check out our other articles here<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Discover how to easily install Windows Subsystem for Linux 2 (WSL 2) on your Windows 10 system and leverage the best of both worlds.<\/p>\n","protected":false},"author":50,"featured_media":17130,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[18],"tags":[],"ppma_author":[1491],"class_list":["post-17106","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials"],"uagb_featured_image_src":{"full":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows.jpg",1200,630,false],"thumbnail":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows-150x150.jpg",150,150,true],"medium":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows-600x315.jpg",600,315,true],"medium_large":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows-768x403.jpg",768,403,true],"large":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows.jpg",1200,630,false],"1536x1536":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows.jpg",1200,630,false],"2048x2048":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/06\/blog-head_how2-install-windows-sub-for-linux-on-ms-windows.jpg",1200,630,false]},"uagb_author_info":{"display_name":"Tobias Mildenberger","author_link":"https:\/\/contabo.com\/blog\/author\/tobias\/"},"uagb_comment_info":0,"uagb_excerpt":"Discover how to easily install Windows Subsystem for Linux 2 (WSL 2) on your Windows 10 system and leverage the best of both worlds.","authors":[{"term_id":1491,"user_id":50,"is_guest":0,"slug":"tobias","display_name":"Tobias Mildenberger","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/077178d5dce6c3d4c0c0396857a7e544bfdf8adf04145fff5160b33a22e28b1f?s=96&d=mm&r=g","0":null,"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/17106","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/users\/50"}],"replies":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/comments?post=17106"}],"version-history":[{"count":5,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/17106\/revisions"}],"predecessor-version":[{"id":17158,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/17106\/revisions\/17158"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/media\/17130"}],"wp:attachment":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/media?parent=17106"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/categories?post=17106"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/tags?post=17106"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=17106"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}