https://github.com/tgsan/wsldh
WSL Docker Hub CLI - A utility for deploying images from Docker Hub to WSL
https://github.com/tgsan/wsldh
docker docker-registry dockerhub wsl wsl2
Last synced: 8 months ago
JSON representation
WSL Docker Hub CLI - A utility for deploying images from Docker Hub to WSL
- Host: GitHub
- URL: https://github.com/tgsan/wsldh
- Owner: TGSAN
- Created: 2022-12-19T20:32:58.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-13T21:03:08.000Z (12 months ago)
- Last Synced: 2025-02-08T18:48:58.016Z (8 months ago)
- Topics: docker, docker-registry, dockerhub, wsl, wsl2
- Language: C#
- Homepage:
- Size: 21.5 KB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
> WSLDH _
WSL Docker Hub CLI
A utility for deploying images from Docker Hub to WSL.
# Requirements
- Windows 10/11
- Windows Subsystem for Linux - [ Click me to install :) ](https://www.microsoft.com/store/productId/9P9TQF7MRM4R)
# Get Started
1. Pick the system image you want on [Docker Hub](https://hub.docker.com/search?q=).
2. Run `wsldh install : --name --dir ` to install.
# Example
## Install the latest version of Debian
> Install to `D:\WSL\Debian` and name to `Debian-Latest`
Run
`wsldh install debian:latest --dir D:\WSL\Debian --name Debian-Latest`
Or
`wsldh i debian:latest -d D:\WSL\Debian -n Debian-Latest`
## Install the specific version of Debian
> Install Debian 8 (jessie) to `D:\WSL\Debian Jessie` and name to `Debian-8`
Run
`wsldh install debian:jessie --dir "D:\WSL\Debian Jessie" --name Debian-8`
Or
`wsldh i debian:jessie -d "D:\WSL\Debian Jessie" -n Debian-8`
# Features
- Use filters to select images.
- Download Docker image(s) from Docker Hub Registry. (without install)
- Install a Docker image to WSL form Docker Hub Registry.
- Export WSL rootfs (.tar) or Docker image (.tar.gz) form WSL.
- Simple management for WSL.
# Usage
```
Commands:
help, h
Display this help.
download, dl
Download Docker image(s) from Docker Hub Registry
Usage: wsldh download <:tag|@digest> [options] [filters]
Example:
wsldh download ubuntu:latest --output .\output\
wsldh download ubuntu@sha256:965fbcae990b0467ed5657caceaec165018ef44a4d2d46c7cdea80a9dff0d1ea --output .\output\
Options:
--output, -o
(Required) Output directory.
--all, -a
Download all selected images. (default: download first image only)
Filters:
--os
Operating system filter. (eg: linux)
--arch
CPU architecture filter. (eg: arm64)
--variant
CPU variant filter. (eg: v8)
install, i
Install a Docker image to WSL form Docker Hub Registry.
Usage: wsldh install <:tag|@digest> [options] [filters]
Example:
wsldh install ubuntu:latest --name Ubuntu-Latest --dir .\WSLRootFS\Ubuntu\
wsldh install ubuntu@sha256:965fbcae990b0467ed5657caceaec165018ef44a4d2d46c7cdea80a9dff0d1ea --name Ubuntu-Latest --dir .\WSLRootFS\Ubuntu\
Options:
--name, -n
(Required) Custom linux distribution name.
--dir, -d
(Required) Linux rootfs install location.
Filters:
--os
Operating system filter. (eg: linux)
--arch
CPU architecture filter. (eg: arm64)
--variant
CPU variant filter. (eg: v8)
export
Export WSL rootfs (.tar) or Docker image (.tar.gz) form WSL.
Usage: wsldh export [options]
Example:
wsldh export Ubuntu-Latest --output .\output\ubuntu.tar.gz --compress
Options:
--output, -o
(Required) Output file path.
--compress, -c
Use GZip to compress.
list, ls
List all installed distribution of WSL.
remove, rm
Remove a distribution from WSL.
Usage: wsldh remove
Example:
wsldh remove Ubuntu-Latest
```