Skip to content

Installing the Windows Subsystem for Linux (WSL)

Bob Yantosca edited this page Jan 3, 2023 · 32 revisions

The Windows Subsystem for Linux allows you to run a Linux session from within your Windows environment.

Prerequisites

  • Windows 11 (or later)
  • Windows 10 version 2004 (build #19041) and later

Installation instructionn

  1. Open Windows Powershell

    • Click on the Windows menu (or hit the Windows key)
    • Type Powershell in the search bar
    • Click on Run as administrator
  2. Type the following at the PowerShell command line to install WSL with Ubuntu Linux. (Note you will be replaced by your Windows username in the PowerShell prompt.)

    PS C:\Users\you> wsl --install -d ubuntu
    PS C:\Users\you> wsl --update
    PS C:\Users\you> wsl --set-default-version 2
  1. Activate WSL. You will be prompted to answer some questions (i.e. specify your Linux username, your password, and your super-user password). You should notice that the prompt will change from the PowerShell prompt to the Linux prompt. (NOTE: your-linux-username will be replaced by what you specify for your Linux username.)
    PS C:\Users\you> wsl
    your-linux-username@localhost~#
  1. Now that you are in a local Ubuntu Linux session, you will want to install some software. You will do this with the apt package manager. Type the following commands at the Linux prompt. (NOTE: For clarity, we have omitted the Linux prompts below. Also comments beginning with # after each command are provided but you don't have to type them.)
    sudo apt update -y && sudo apt upgrade -y     # Get the latest packages from Ubuntu
    sudo apt install -y git-gui                   # Git GUI (NOTE: Git is installed by default)
    sudo apt install -y gitk                      # GitK browser
    sudo apt install -y xserver-xorg              # X11 server
    sudo apt install -y xserver-xorg-core         # X11 server core files
    sudo apt install -y x11-apps                  # Basic X11 applications (e.g. xeyes)
    sudo apt install -y xfonts-base               # Fonts for X11
    sudo apt install -y xfonts-75dpi              # Fonts for X11
    sudo apt install -y xfonts-100dpi             # Fonts for X11
    sudo apt install -y xorg-x11-fonts            # Fonts for X11
    sudo apt install -y fonts-dejavu              # DejaVu fonts (used by several apps)
    sudo apt install -y gnu-emacs                 # Emacs editor (useful for editing configuration files)

Clone this wiki locally