{"id":16493509,"url":"https://github.com/tgsan/wsldh","last_synced_at":"2025-10-27T21:31:01.697Z","repository":{"id":88135742,"uuid":"580142764","full_name":"TGSAN/wsldh","owner":"TGSAN","description":"WSL Docker Hub CLI - A utility for deploying images from Docker Hub to WSL","archived":false,"fork":false,"pushed_at":"2024-10-13T21:03:08.000Z","size":22,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-08T18:48:58.016Z","etag":null,"topics":["docker","docker-registry","dockerhub","wsl","wsl2"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TGSAN.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-19T20:32:58.000Z","updated_at":"2024-10-13T21:01:41.000Z","dependencies_parsed_at":"2023-05-18T10:15:59.256Z","dependency_job_id":null,"html_url":"https://github.com/TGSAN/wsldh","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TGSAN%2Fwsldh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TGSAN%2Fwsldh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TGSAN%2Fwsldh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TGSAN%2Fwsldh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TGSAN","download_url":"https://codeload.github.com/TGSAN/wsldh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238560798,"owners_count":19492595,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-registry","dockerhub","wsl","wsl2"],"created_at":"2024-10-11T14:09:46.027Z","updated_at":"2025-10-27T21:30:56.394Z","avatar_url":"https://github.com/TGSAN.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://store-images.s-microsoft.com/image/apps.61786.14131597032361940.38d2a067-3798-455f-934a-f69935156b3d.eb49d3ac-e311-4e6f-b89b-f1fe8db9d73b\" width=\"100px\"\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\u003cb\u003e\u003e WSLDH _\u003c/b\u003e\u003c/h3\u003e\n\n\u003ch1 align=\"center\"\u003e\n  WSL Docker Hub CLI\n\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003eA utility for deploying images from Docker Hub to WSL.\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/TGSAN/wsldh/releases/latest\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/downloads/TGSAN/wsldh/total?style=for-the-badge\"\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/TGSAN/wsldh/releases/latest\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/v/release/TGSAN/wsldh?style=for-the-badge\u0026include_prereleases\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n# Requirements\n- Windows 10/11  \n- Windows Subsystem for Linux - [ Click me to install :) ](https://www.microsoft.com/store/productId/9P9TQF7MRM4R)  \n\n# Get Started\n1. Pick the system image you want on [Docker Hub](https://hub.docker.com/search?q=).  \n2. Run `wsldh install \u003cImageName\u003e:\u003cTag\u003e --name \u003cCustomName\u003e --dir \u003cInstallDir\u003e` to install.  \n\n# Example\n## Install the latest version of Debian\n\u003e Install to `D:\\WSL\\Debian` and name to `Debian-Latest`\n\nRun  \n`wsldh install debian:latest --dir D:\\WSL\\Debian --name Debian-Latest`  \nOr  \n`wsldh i debian:latest -d D:\\WSL\\Debian -n Debian-Latest`  \n\n## Install the specific version of Debian\n\u003e Install Debian 8 (jessie) to `D:\\WSL\\Debian Jessie` and name to `Debian-8`  \n\nRun  \n`wsldh install debian:jessie --dir \"D:\\WSL\\Debian Jessie\" --name Debian-8`  \nOr  \n`wsldh i debian:jessie -d \"D:\\WSL\\Debian Jessie\" -n Debian-8`  \n\n# Features\n- Use filters to select images.\n- Download Docker image(s) from Docker Hub Registry. (without install)  \n- Install a Docker image to WSL form Docker Hub Registry.  \n- Export WSL rootfs (.tar) or Docker image (.tar.gz) form WSL.  \n- Simple management for WSL.  \n\n# Usage\n```\nCommands:\n\n  help, h\n    Display this help.\n\n  download, dl\n    Download Docker image(s) from Docker Hub Registry\n\n      Usage: wsldh download \u003cimage\u003e\u003c:tag|@digest\u003e [options] [filters]\n\t\t\t\n      Example:\n        wsldh download ubuntu:latest --output .\\output\\\n        wsldh download ubuntu@sha256:965fbcae990b0467ed5657caceaec165018ef44a4d2d46c7cdea80a9dff0d1ea --output .\\output\\\n\n      Options:\n        --output, -o \u003cpath\u003e\n          (Required) Output directory.\n        --all, -a\n          Download all selected images. (default: download first image only)\n\n      Filters:\n        --os \u003cos\u003e\n          Operating system filter. (eg: linux)\n        --arch \u003carch\u003e\n          CPU architecture filter. (eg: arm64)\n        --variant \u003cvariant\u003e\n          CPU variant filter. (eg: v8)\n\n  install, i\n    Install a Docker image to WSL form Docker Hub Registry.\n\n    Usage: wsldh install \u003cimage\u003e\u003c:tag|@digest\u003e [options] [filters]\n\n    Example:\n      wsldh install ubuntu:latest --name Ubuntu-Latest --dir .\\WSLRootFS\\Ubuntu\\\n      wsldh install ubuntu@sha256:965fbcae990b0467ed5657caceaec165018ef44a4d2d46c7cdea80a9dff0d1ea --name Ubuntu-Latest --dir .\\WSLRootFS\\Ubuntu\\\n\n    Options:\n      --name, -n \u003cname\u003e\n        (Required) Custom linux distribution name.\n      --dir, -d \u003cpath\u003e\n        (Required) Linux rootfs install location.\n\n    Filters:\n      --os \u003cos\u003e\n        Operating system filter. (eg: linux)\n      --arch \u003carch\u003e\n        CPU architecture filter. (eg: arm64)\n      --variant \u003cvariant\u003e\n        CPU variant filter. (eg: v8)\n\n  export\n    Export WSL rootfs (.tar) or Docker image (.tar.gz) form WSL.\n\n    Usage: wsldh export \u003cdistribution name\u003e [options]\n\n    Example:\n      wsldh export Ubuntu-Latest --output .\\output\\ubuntu.tar.gz --compress\n\n    Options:\n      --output, -o \u003cpath\u003e\n        (Required) Output file path.\n      --compress, -c\n        Use GZip to compress.\n\n  list, ls\n    List all installed distribution of WSL.\n\n  remove, rm\n\tRemove a distribution from WSL.\n\n\tUsage: wsldh remove \u003cdistribution name\u003e\n\n\tExample:\n\t  wsldh remove Ubuntu-Latest\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftgsan%2Fwsldh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftgsan%2Fwsldh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftgsan%2Fwsldh/lists"}