wsl-get

A command line tool to install any Linux distribution on WSL2.

Requirements

• Rust compiler

• Docker Desktop

  This program uses the docker command to get a rootfs tarball that can be used with WSL.

  You can install Docker Desktop via winget:

  > winget install docker
  

Install

> cargo install wsl-get

Usage

Install distribution

> wsl-get install <distribution>

To find available distributions and versions, search on Docker Hub. And you can install it by just replacing docker pull with wsl-get install in the command. For example,

Installing Ubuntu:

> wsl-get install ubuntu

Installing specified version of distribution:

> wsl-get install ubuntu:21.04

You can specify the name of installation.

> wsl-get install <distribution> <install-name>

You can create many instances of same distribution.

> wsl-get install ubuntu ubuntu-1
> wsl-get install ubuntu ubuntu-2
> wsl-get install ubuntu ubuntu-3

Uninstall distribution

> wsl-get uninstall <distribution>

List installed distributions

> wsl-get list

Just same as wsl.exe --list.

Set default user of distribution

> wsl-get set-default-user <distribution> <username>

Download rootfs tarball

You can download the rootfs tarball in order to install the distribution yourself using the wsl.exe command.

> wsl-get download <distribution>

For more information, please run wsl-get help.