Install Windows Subsystem for Linux on your EC2 Windows instance - Amazon Elastic Compute Cloud
Install WSL on your Windows instance
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

Install Windows Subsystem for Linux on your EC2 Windows instance

The Windows Subsystem for Linux (WSL) is a feature of Microsoft Windows. By installing WSL on your EC2 Windows instance, you can run native Linux tools directly on your Windows instance.

There are two versions of Windows Subsystem for Linux (WSL): WSL 1 and WSL 2. For more information, see Windows Subsystem for Linux Documentation on the Microsoft website.

Requirements

  • The operating system must be Windows Server 2019 or later.

  • You can only install WSL 1 on virtualized Windows instances (the instance size is not .metal or does not support nested virtualization).

  • You can install either WSL 1 or WSL 2 on instances that support nested virtualization and have the NestedVirtualization CPU Option enabled.

  • You can install either WSL 1 or WSL 2 on bare metal instances (the instance size is .metal). Bare metal instances provide the required support for nested virtualization by default.

For more information about nested virtualization for EC2, see Use nested virtualization to run hypervisors in Amazon EC2 instances.

Install WSL on your Windows instance

To install WSL 1

  1. Install WSL. The process that you'll use depends on the version of Windows Server running on the instance.

    • Windows Server 2022 and later - Run the following standard installation command on your EC2 instance.

      wsl --install --enable-wsl1 --no-launch

    • Windows Server 2019 - Enable WSL and then install WSL as described in Install WSL on previous versions of Windows Server on the Microsoft website.

  2. Restart your EC2 instance.

    shutdown -r -t 20

  3. To configure WSL to use WSL 1, run the following command on your instance. This step is required for virtualized instances (the instance size is not .metal or not configured for nested virtualization).

    wsl --set-default-version 1

  4. Install the default distribution.

    wsl --install
To install WSL 2 (.metal or instances with nested virtualization enabled)

Run the following standard installation command on your EC2 instance. By default, WSL 2 is installed.

wsl --install