{"id":13942208,"url":"https://github.com/yosukes-dev/AmazonWSL","last_synced_at":"2025-07-20T05:32:23.454Z","repository":{"id":46089024,"uuid":"242507355","full_name":"yosukes-dev/AmazonWSL","owner":"yosukes-dev","description":"Amazon Linux as a WSL Instance. Supports multiple install.","archived":false,"fork":false,"pushed_at":"2024-01-10T11:37:23.000Z","size":2984,"stargazers_count":123,"open_issues_count":7,"forks_count":21,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-11-27T11:39:07.588Z","etag":null,"topics":["amazon-linux","wsl"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yosukes-dev.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}},"created_at":"2020-02-23T11:48:51.000Z","updated_at":"2024-10-21T02:11:37.000Z","dependencies_parsed_at":"2024-04-17T03:50:22.137Z","dependency_job_id":"74519a94-9f4a-4a68-93d6-80bf01831ea2","html_url":"https://github.com/yosukes-dev/AmazonWSL","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/yosukes-dev/AmazonWSL","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FAmazonWSL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FAmazonWSL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FAmazonWSL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FAmazonWSL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yosukes-dev","download_url":"https://codeload.github.com/yosukes-dev/AmazonWSL/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FAmazonWSL/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266071519,"owners_count":23871940,"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":["amazon-linux","wsl"],"created_at":"2024-08-08T02:01:45.097Z","updated_at":"2025-07-20T05:32:18.435Z","avatar_url":"https://github.com/yosukes-dev.png","language":"Makefile","readme":"# AmazonWSL\nAmazon Linux on WSL (Windows 10 FCU or later)\nbased on [wsldl](https://github.com/yuk7/wsldl)\n\n![screenshot](https://raw.githubusercontent.com/yosukes-dev/AmazonWSL/master/img/screenshot.png)\n\n[![CircleCI](https://circleci.com/gh/yosukes-dev/AmazonWSL.svg?style=svg)](https://circleci.com/gh/yosukes-dev/AmazonWSL)\n[![Github All Releases](https://img.shields.io/github/downloads/yosukes-dev/AmazonWSL/total.svg?style=flat-square)](https://github.com/yosukes-dev/AmazonWSL/releases)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n![License](https://img.shields.io/github/license/yosukes-dev/AmazonWSL.svg?style=flat-square)\n\n### [Download](https://github.com/yosukes-dev/AmazonWSL/releases)\n\n## An instruction on AWS Developer Tools Blog\nThe following link is to an article on the AWS Developer Tools Blog describing development with AmazonWSL.    \n[Developing on Amazon Linux 2 using Windows - AWS Developer Tools Blog](https://aws.amazon.com/jp/blogs/developer/developing-on-amazon-linux-2-using-windows/)\n\n## Requirements\n* Windows 10 Fall Creators Update x64 or later. \n* Windows Subsystem for Linux feature is enabled.\n\n## Install\n#### 1. [Download](https://github.com/yosukes-dev/AmazonWSL/releases) installer zip\n\n#### 2. Extract all files in zip file to same directory\n\n#### 3.Run Amazon2.exe to Extract rootfs and Register to WSL\nExe filename is using to the instance name to register.\nIf you rename it you can register with a diffrent name and have multiple installs.\n\n## Icon settings for Windows Terminal\n![terminal-icon](https://raw.githubusercontent.com/yosukes-dev/AmazonWSL/master/img/terminal-icon.png)\n\nThe following is an example of `profiles.json` if you extracted to `C:\\`\n```\n{\n    \"guid\": \"{dc13e3b1-2863-5b9b-9749-3a31bc67a12a}\",\n    \"hidden\": false,\n    \"name\": \"Amazon2\",\n    \"source\": \"Windows.Terminal.Wsl\",\n    \"icon\": \"C:\\\\Amazon2\\\\assets\\\\icon.png\"\n}\n```\n\n## How-to-Use(for Installed Instance)\n#### exe Usage\n```dos\nUsage :\n    \u003cno args\u003e\n      - Open a new shell with your default settings.\n\n    run \u003ccommand line\u003e\n      - Run the given command line in that distro. Inherit current directory.\n\n    runp \u003ccommand line (includes windows path)\u003e\n      - Run the path translated command line in that distro.\n\n    config [setting [value]]\n      - `--default-user \u003cuser\u003e`: Set the default user for this distro to \u003cuser\u003e\n      - `--default-uid \u003cuid\u003e`: Set the default user uid for this distro to \u003cuid\u003e\n      - `--append-path \u003con|off\u003e`: Switch of Append Windows PATH to $PATH\n      - `--mount-drive \u003con|off\u003e`: Switch of Mount drives\n      - `--default-term \u003cdefault|wt|flute\u003e`: Set default terminal window\n\n    get [setting]\n      - `--default-uid`: Get the default user uid in this distro\n      - `--append-path`: Get on/off status of Append Windows PATH to $PATH\n      - `--mount-drive`: Get on/off status of Mount drives\n      - `--wsl-version`: Get WSL Version 1/2 for this distro\n      - `--default-term`: Get Default Terminal for this distro launcher\n      - `--lxguid`: Get WSL GUID key for this distro\n\n    backup [contents]\n      - `--tgz`: Output backup.tar.gz to the current directory using tar command\n      - `--reg`: Output settings registry file to the current directory\n\n    clean\n      - Uninstall the distro.\n\n    help\n      - Print this usage message.\n```\n\n#### Just Run exe\n```cmd\n\u003eAmazon2.exe\n[root@PC-NAME user]#\n```\n\n#### Run with command line\n```cmd\n\u003eAmazon2.exe run uname -r\n4.4.0-43-Microsoft\n```\n\n#### Run with command line with path translation\n```cmd\n\u003eAmazon2.exe runp echo C:\\Windows\\System32\\cmd.exe\n/mnt/c/Windows/System32/cmd.exe\n```\n\n#### Change Default User(id command required)\n\nThe following is an example of adding a user to the \"users\" and \"wheel\" groups and setting it as the default user\n\n_Note: Replace `user` with your chosen user name._\n\n```cmd\n\u003eAmazon2.exe run useradd -m -g users -G wheel -s /bin/bash user\n\n\u003eAmazon2.exe config --default-user user\n\n\u003eAmazon2.exe\n[user@PC-NAME dir]$\n```\n\n#### Set \"Windows Terminal\" as default terminal\n```cmd\n\u003eAmazon2.exe config --default-term wt\n```\n\n#### How to uninstall instance\n```dos\n\u003eAmazon2.exe clean\n\n```\n","funding_links":[],"categories":["Unofficial Distributions","Makefile"],"sub_categories":["10. GUI Apps"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyosukes-dev%2FAmazonWSL","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyosukes-dev%2FAmazonWSL","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyosukes-dev%2FAmazonWSL/lists"}