{"id":14069511,"url":"https://github.com/n-murray/wsl-automated-setup","last_synced_at":"2025-07-30T05:32:27.661Z","repository":{"id":224201974,"uuid":"442798686","full_name":"n-murray/wsl-automated-setup","owner":"n-murray","description":"The WSL automated setup project is designed to make creating your own WSL distro using a combination of Dockerfiles and scripts.","archived":false,"fork":false,"pushed_at":"2022-08-13T21:19:30.000Z","size":2826,"stargazers_count":15,"open_issues_count":0,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-04T10:39:48.472Z","etag":null,"topics":["docker","dockerfile","windows","wsl"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/n-murray.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2021-12-29T14:32:30.000Z","updated_at":"2024-08-24T00:45:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"a0703227-2268-412c-a13c-04f9a777e074","html_url":"https://github.com/n-murray/wsl-automated-setup","commit_stats":null,"previous_names":["n-murray/wsl-automated-setup"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/n-murray/wsl-automated-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-murray%2Fwsl-automated-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-murray%2Fwsl-automated-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-murray%2Fwsl-automated-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-murray%2Fwsl-automated-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/n-murray","download_url":"https://codeload.github.com/n-murray/wsl-automated-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n-murray%2Fwsl-automated-setup/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267815187,"owners_count":24148356,"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","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","dockerfile","windows","wsl"],"created_at":"2024-08-13T07:07:00.555Z","updated_at":"2025-07-30T05:32:24.745Z","avatar_url":"https://github.com/n-murray.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# WSL Automated Setup\r\n\u003ctable\u003e\r\n    \u003ctr\u003e\r\n        \u003ctd\u003e\r\nThe WSL Automated Setup project is a set of scripts that can make the installation and creation of custom distros for WSL a simple process. It allows a user to create a custom WSL install and tear it down again when no longer needed or broken. \r\n\r\nThe purpose of the scripts in this repo are to make the creation of development ready WSL distros easy by \r\nautomating the creation of a custom distro using Docker containers.\r\n    \u003c/td\u003e\r\n    \u003ctd\u003e\r\n    \u003cimg src=\"./resources/images/wsl-preview.jpg\"\r\n     alt=\"WSL Installations\" /\u003e\r\n        \u003c/td\u003e\r\n    \u003c/tr\u003e\r\n\u003c/table\u003e\r\n\r\n___\r\n## Installation Instructions\r\n\r\n\u003e ### Prerequisites\r\n\u003e For the installation you will need the following:\r\n\u003e - Git (If cloning the repository)\r\n\r\n**Docker Desktop is now optional**\r\n\r\nIf not installed a minimal Alpine Linux distro will be installed and act as a builder which will install Docker and create our distro.\r\nOnce installation is complete the builder distro is removed.\r\n\r\n___\r\n### If WSL is enabled already\r\nIf you have got WSL and WSL2 enabled already on your computer and you have Docker Desktop installed you simply\r\nneed to run the ***\"build_environment.bat\"*** file in this folder. This script will build a Docker container using a\r\nDockerfile which installs the required applications for development eg... Java, Maven, Python and Docker. ***If the tar file \"dev-env.tar.gz\" already exists from previous runs it will be used instead of recreating it.***\r\n\r\nIf for whatever reason you want to remove the installed WSL distro you can run the ***\"remove_environment.bat\"***\r\nwhich will remove the distro and the network configurations. To re-install the custom WSL distro again just \r\nre-run the build_environment.bat and it will install a fresh distro.\r\n___\r\n### If WSL is not already enabled on your computer\r\nIf you have not got WSL enabled and you are using Windows 10 version 2004 or higher you can install WSL by simply running the following command in an administrator Powershell or Command Prompt window.\r\n\r\n```\r\n    wsl --install\r\n```\r\n\r\nThis command will enable all of the required components, download the latest Linux kernel and set WSL 2 as your default while also installing Ubuntu by default.\r\n\r\n***For more information check the official documentation below***\r\n\r\n\u003e https://docs.microsoft.com/en-us/windows/wsl/install\r\n\r\n___\r\nIf you have an older version of Windows 10 you can enable WSL by running the scripts found in the \"Initial WSL install scripts\" folder. \r\nThese scripts will enable the required features and download the required kernel update for WSL2 and install it.\r\nThe commands in these scripts are from the official Microsoft installation guide: https://docs.microsoft.com/en-us/windows/wsl/install-win10\r\nI have just automated the instructions using batch files, however you can just follow that guide if \r\nyou would prefer not to run them.\r\n\r\n### Brief Script Expalanation:\r\n\r\nenable-wsl2-part1.bat:\r\nThis script enables the WSL and Virtual machine platform optional Windows features that are\r\nneeded to run WSL and WSL2\r\n\r\nenable-wsl2-part2.bat: This script downloads the Linux kernel update installer required for\r\nrunning WSL2, it then runs the installer.\r\n___\r\n***Windows 11***  \r\n\u003e For Windows 11 you can install WSL from the Microsoft Store. Currently in preview here: https://www.microsoft.com/store/productId/9P9TQF7MRM4R\r\n___","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn-murray%2Fwsl-automated-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fn-murray%2Fwsl-automated-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn-murray%2Fwsl-automated-setup/lists"}