Skip to content

Latest commit

 

History

History
46 lines (40 loc) · 3.9 KB

wsl_tutorial.md

File metadata and controls

46 lines (40 loc) · 3.9 KB

Setting up the Windows Subsystem for Linux (WSL) on a Windows 10 (build version 14393) or newer

The first step of this process is ensuring that the version of Windows being used supports WSL. The easiest way to do this is to right click the start menu button and select "System"

Opening the system window

The window that pops up will show the current system information. The item of interest is found on the "OS Build" entry.

Finding your version

Short version for newer or updated computers

For Windows 10 systems with an OS Build version newer or equal to 19041 or if the computer runs Windows 11, setting up WSL and installing Ubuntu is a very straightforward task.

  1. Right click your start menu button again
  2. Select either "Windows PowerShell (Admin)" or "Command Prompt (Admin)" (whichever you see)
  3. In the terminal that opens, copy and paste the following command:
    wsl --install
  4. Restart the computer once the installation is complete
  5. There should be a Ubuntu application in your start menu now Congrats! If any problems are experienced or if the computer does not meet the above criteria, consider following the next section

"Long" version for older computers

If the Windows computer's OS Build version is between 14393 and 19041 or the above method did not work, this is the process to enable WSL on your system and install Ubuntu.

  1. Type Win + S to bring up the search bar
  2. Search for "Turn Windows Features On or Off"
    search_bar_features
  3. In the new window, scroll toward the bottom and ensure that both the boxes for "Virtual Machine Platform" (if present) and "Windows Subsystem for Linux" are checked
    windows_features
  4. Click "OK"
  5. After the process is complete, RESTART THE COMPUTER
  6. Upon reboot, use Win + S again to search for "store" and open up the Microsoft Store
    windows store
  7. In the search bar for the store, search for "Ubuntu"
    get ubuntu
  8. Select the "Ubuntu" with no numbers or version after it
    install ubuntu
  9. Press "Get" to install Ubuntu
  10. After it has downloaded, it will either start the installer on its own or press "Install" or select "Ubuntu" from the start menu
  11. The Ubuntu installer may take time to run. To ensure that the installation is proceeding, click the drop down next to "Unpacking the distro." This will expose a terminal that shows the progress of the installation or note any errors in the install.
    installing
  12. Once complete, run "Ubuntu" by either selecting it in the start menu, searching for it, or pressing "Run" in the Store app
  13. The new terminal will run some minor setup operations and then prompt the user to create a name and password
    username
  14. Once the username and password are created, the Ubuntu app will be the terminal used for all other Linux-based operations on a Windows machine.
    Finished