{"id":6916,"date":"2021-07-30T11:07:17","date_gmt":"2021-07-30T18:07:17","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/commandline\/?p=6916"},"modified":"2021-07-30T11:07:41","modified_gmt":"2021-07-30T18:07:41","slug":"install-wsl-with-a-single-command-now-available-in-windows-10-version-2004-and-higher","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/commandline\/install-wsl-with-a-single-command-now-available-in-windows-10-version-2004-and-higher\/","title":{"rendered":"Install WSL with a single command now available in Windows 10 version 2004 and higher"},"content":{"rendered":"

In the latest Windows Insider Preview builds, you can install everything you need to run WSL just by running wsl.exe --install<\/code>. We\u2019re excited to announce that this functionality is now officially backported to Windows 10 version 2004 and higher, which will make installing WSL on those builds much easier!<\/p>\n

Using wsl --install<\/code><\/h2>\n

\"Image<\/a><\/p>\n

The process to set up WSL was previously too complicated, involving turning on multiple settings and installing multiple packages. We\u2019ve simplified the process down to just one command, simply open a command prompt window with admin privileges and run wsl.exe --install<\/code>. Once you hit enter, the process will automatically enable the WSL optional features required, install the Ubuntu distribution by default, and install the latest WSL Linux kernel version onto your machine. When it\u2019s completed and you restart your machine, your distribution will start after you boot up again, completing the installation.<\/p>\n

Additionally, you can find a list of Linux distributions available to install by entering the command wsl --list --online<\/code> in PowerShell or Windows Command Prompt. To install a distribution other than, or in addition to, the Ubuntu default, use this command: wsl --install -d <DistroName><\/code><\/p>\n

Replace <DistroName><\/code> with the name of a Linux distribution found in the previous list command. This install command can be used for first time installation or for adding additional distributions after you already have WSL installed with the default Ubuntu distribution.<\/p>\n

Additional commands<\/h3>\n

We\u2019ve also included some additional commands to help you manage your WSL instances with this backport.<\/p>\n

You can use wsl --update<\/code> to manually update your WSL Linux kernel, and you can use wsl --update rollback<\/code> to rollback to a previous WSL Linux kernel version.<\/p>\n

Lastly, you can use wsl --status<\/code> to see general information about your WSL configuration, such as default distro type, default distro, and kernel version.<\/p>\n

Update your Windows 10 version to support these commands<\/h2>\n

You can get this backport just by updating Windows like normal. To manually do this open Windows Settings, go to \u2018Updates and Security\u2019 and hit \u2018Check for Updates\u2019.<\/p>\n

\"Windows<\/a><\/p>\n

This update is part of KB5004296 and you can find full instructions on how to ensure you have it installed and its changes here<\/a>. At the time of writing, when you click \u201cCheck for Updates\u201d you might see an available optional update, ensure that it has the same number as KB5004296, install it, and you\u2019ll get access to wsl --update<\/code>.<\/p>\n

Where to give us your feedback<\/h2>\n

As always, you can follow up with WSL team members<\/a>, or with me on Twitter<\/a>. If you\u2019re experiencing technical issues please file them on the Microsoft\/WSL Github repo<\/a>. Learn more about WSL, including how to set up common development tools like Git, VS Code, Docker containers, databases, GPU acceleration for machine learning, and more, by visiting the WSL documentation<\/a>. Happy coding!<\/p>\n","protected":false},"excerpt":{"rendered":"

In the latest Windows Insider Preview builds, you can install everything you need to run WSL just by running wsl.exe –install. We\u2019re excited to announce that this functionality is now officially backported to Windows 10 version 2004 and higher, which will make installing WSL on those builds much easier! Using wsl –install The process to […]<\/p>\n","protected":false},"author":2191,"featured_media":6917,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,9],"tags":[],"class_list":["post-6916","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-commandline","category-bash-on-ubuntu-on-windows"],"acf":[],"blog_post_summary":"

In the latest Windows Insider Preview builds, you can install everything you need to run WSL just by running wsl.exe –install. We\u2019re excited to announce that this functionality is now officially backported to Windows 10 version 2004 and higher, which will make installing WSL on those builds much easier! Using wsl –install The process to […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/posts\/6916","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/users\/2191"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/comments?post=6916"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/posts\/6916\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/media\/6917"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/media?parent=6916"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/categories?post=6916"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/commandline\/wp-json\/wp\/v2\/tags?post=6916"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}