How to shutdown Linux distros on WSL

If you use WSL, you can use a couple of commands to shut down one or all Linux distros manually, and here's how.

January 6, 2023

2023-01-06T11:00:38-05:00

Although the Windows Subsystem for Linux (WSL) is a convenient way to run Linux distros alongside Windows 11 or Windows 10, the lightweight virtual machine will continue to run in the background even when you exit the command shell, wasting system resources.

If you prefer to terminate the Linux distro (Ubuntu, Kali, Debian, Mint, etc.) as soon as you are done using it or have to restart it, use a wsl.exe command-line tool to shut down one or all distributions manually.

This guide will teach you the steps to shut down Linux distros running on the WSL2 platform on Windows 10 and 11.

Terminate a Linux distro on WSL
Terminate all Linux distros on WSL

Terminate a Linux distro on WSL

To terminate a Linux distro on WSL running on Windows 11 or Windows 10, use these steps:

Open Start.
Search for Command Prompt (or PowerShell), right-click the top result, and select the Run as administrator option.
Type the following command to view all running WSL distros and press Enter:
```
wsl --list --verbose
```
Type the following command to shut down the Linux distro on Windows 11 or Windows 10 and press Enter:
```
wsl -t DISTRO-NAME
```
In the command, replace DISTRO-NAME with the name of the distro you want to shut down, as shown in step 3. For example, wsl -t Ubuntu-20.04.
(Optional) Type the following command to confirm the distro is “stopped” and press Enter:
```
wsl --list --verbose
```

Once you complete the steps, the distro running on the Windows Subsystem for Linux will gracefully shut down. You can always repeat the steps to terminate other distros or use the steps below to shut them all down.

Terminate all Linux distros on WSL

To shut down all the WSL distros running on Windows 10 (or 11), use these steps:

Open Start.
Search for Command Prompt (or PowerShell), right-click the top result, and select the Run as administrator option.
Type the following command to view all running WSL distros and press Enter:
```
wsl --list --verbose
```
Type the following command to shut down the Linux distributions running on Windows and press Enter:
```
wsl --shutdown
```
(Optional) Type the following command to confirm the distros are “stopped,” and press Enter:
```
wsl --list --verbose
```

After you complete the steps, all the WSL distros will terminate immediately on Windows 11 or 10.

If you need to restart the Linux distro, spin it again from the Start menu, or use Command Prompt or PowerShell and run the wsl --distribution DISTRO-NAME command (replace the DISTRO-NAME with the actual name of the distro before running the command).