-
Notifications
You must be signed in to change notification settings - Fork 0
/
wsl_tutorial.html
44 lines (44 loc) · 4.67 KB
/
wsl_tutorial.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
<h1 id="setting-up-the-windows-subsystem-for-linux-wsl-on-a-windows-10-build-version-14393-or-newer">Setting up the Windows Subsystem for Linux (WSL) on a Windows 10 (build version 14393) or newer</h1>
<p>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"</p>
<p><img src="https://user-images.githubusercontent.com/25447319/191636841-c19aa383-5442-4679-9b22-c6d10e3dd990.png" alt="Opening the system window"></p>
<p>The window that pops up will show the current system information. The item of interest is found on the "OS Build" entry.</p>
<p><img src="https://user-images.githubusercontent.com/25447319/191636625-9e5237b2-b83b-4f4f-994e-7f1b0cf6c477.png" alt="Finding your version"></p>
<hr>
<h2 id="short-version-for-newer-or-updated-computers">Short version for newer or updated computers</h2>
<p>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.</p>
<ol>
<li>Right click your start menu button again</li>
<li>Select either <strong>"Windows PowerShell (Admin)"</strong> or <strong>"Command Prompt (Admin)"</strong> (whichever you see)</li>
<li>In the terminal that opens, copy and paste the following command:</br>
<code>wsl --install</code></br></li>
<li>Restart the computer once the installation is complete</li>
<li>There should be a Ubuntu application in your start menu now
<strong>Congrats!</strong> If any problems are experienced or if the computer does not meet the above criteria, consider following the next section</li>
</ol>
<hr>
<h2 id="-long-version-for-older-computers">"Long" version for older computers</h2>
<p>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.</p>
<ol>
<li>Type <code>Win + S</code> to bring up the search bar</li>
<li>Search for "Turn Windows Features On or Off"</br>
<img src="https://user-images.githubusercontent.com/25447319/191638673-1b52b10b-b2e9-4e48-a25d-a3d151e11306.png" alt="search_bar_features"></br></li>
<li>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</br>
<img src="https://user-images.githubusercontent.com/25447319/191638970-3743ffe3-58aa-4959-a9a4-2d3ccf26c74e.png" alt="windows_features"></br></li>
<li>Click "OK"</li>
<li>After the process is complete, <strong>RESTART THE COMPUTER</strong></li>
<li>Upon reboot, use <code>Win + S</code> again to search for "store" and open up the Microsoft Store</br>
<img src="https://user-images.githubusercontent.com/25447319/191639193-3439d720-a3c0-42bd-b75d-570ac0775250.png" alt="windows store"></br></li>
<li>In the search bar for the store, search for "Ubuntu"</br>
<img src="https://user-images.githubusercontent.com/25447319/191639278-e232d0a1-6991-4952-a301-54d09ee8a590.png" alt="get ubuntu"></br></li>
<li>Select the "Ubuntu" with <strong>no numbers or version after it</strong></br>
<img src="https://user-images.githubusercontent.com/25447319/191639385-74e07cd3-6314-43d3-ad94-c5136e26ff7f.png" alt="install ubuntu"></br></li>
<li>Press "Get" to install Ubuntu</li>
<li>After it has downloaded, it will either start the installer on its own or press "Install" or select "Ubuntu" from the start menu</li>
<li>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.</br>
<img src="https://user-images.githubusercontent.com/25447319/191639748-0bb4d9a8-96b5-4945-99f6-2e73e0ac2bc7.png" alt="installing"></br></li>
<li>Once complete, run "Ubuntu" by either selecting it in the start menu, searching for it, or pressing "Run" in the Store app</li>
<li>The new terminal will run some minor setup operations and then prompt the user to create a name and password</br>
<img src="https://user-images.githubusercontent.com/25447319/191639975-64f53c5e-f51e-41a9-a4af-4bcbcb6ad49e.png" alt="username"></br></li>
<li>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.</br>
<img src="https://user-images.githubusercontent.com/25447319/191640579-2e1d41b7-48b7-4380-92f4-1cce4c802f2f.png" alt="Finished"></li>
</ol>