#distribution #cli #install #linux-distro #command-line-tool #wsl #wsl2

app wsl-get

A command line tool to install any Linux distribution on WSL2

1 unstable release

0.1.0 Jun 19, 2021

#4 in #wsl2

MIT license

22KB
481 lines

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.

Dependencies

~139MB
~2.5M SLoC