{"id":13566309,"url":"https://github.com/yosukes-dev/RHWSL","last_synced_at":"2025-04-04T00:30:26.408Z","repository":{"id":39913003,"uuid":"242995980","full_name":"yosukes-dev/RHWSL","owner":"yosukes-dev","description":"Red hat UBI as a WSL Instance. Supports multiple install.","archived":true,"fork":false,"pushed_at":"2023-01-24T07:28:04.000Z","size":1596,"stargazers_count":129,"open_issues_count":4,"forks_count":20,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-11-04T20:42:25.272Z","etag":null,"topics":["redhat","redhat-enterprise-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}},"created_at":"2020-02-25T12:36:39.000Z","updated_at":"2024-07-03T08:25:00.000Z","dependencies_parsed_at":"2023-02-13T19:02:31.505Z","dependency_job_id":null,"html_url":"https://github.com/yosukes-dev/RHWSL","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FRHWSL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FRHWSL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FRHWSL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yosukes-dev%2FRHWSL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yosukes-dev","download_url":"https://codeload.github.com/yosukes-dev/RHWSL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247103305,"owners_count":20884023,"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":["redhat","redhat-enterprise-linux","wsl"],"created_at":"2024-08-01T13:02:06.766Z","updated_at":"2025-04-04T00:30:25.674Z","avatar_url":"https://github.com/yosukes-dev.png","language":"Makefile","funding_links":[],"categories":["Makefile","Unofficial Distributions"],"sub_categories":["10. GUI Apps"],"readme":"# RHWSL (Red hat UBI on WSL)\nRed hat redistributable Standard UBI on WSL (Windows 10 Windows 10 FCU or later)\nbased on [wsldl](https://github.com/yuk7/wsldl)\n\n![screenshot](https://raw.githubusercontent.com/yosukes-dev/RHWSL/master/img/screenshot.png)\n\n[![CircleCI](https://circleci.com/gh/yosukes-dev/RHWSL.svg?style=svg)](https://circleci.com/gh/yosukes-dev/RHWSL)\n[![Github All Releases](https://img.shields.io/github/downloads/yosukes-dev/RHWSL/total.svg?style=flat-square)](https://github.com/yosukes-dev/RHWSL/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/RHWSL.svg?style=flat-square)\n\n### [Download](https://github.com/yosukes-dev/RHWSL/releases)\n\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/RHWSL/releases) installer zip\n\n#### 2. Extract all files in zip file to same directory\n\n#### 3.Run RHWSL.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## (Option)\n- If you want to use WSL2, convert it with the following command.\n```dos\nwsl --set-version RHWSL 2\n```\n\n## Subscription Manager\n- The rootfs included in the release file is the redistributable Standard __\"Universal Base Image\"__.  \n  __However, you can register as usual using subscription-manager and use the RHEL repositories.__\n```sh\n[root@\u003cyourhost\u003e RHWSL]# subscription-manager register\nYou are attempting to use a locale that is not installed.\nRegistering to: subscription.rhsm.redhat.com:443/subscription\nUsername: \u003cyourusername\u003e\nPassword: \u003cyourpassword\u003e\nThe system has been registered with ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\nThe registered system name is: \u003cyourhost\u003e\n[root@\u003cyourhost\u003e RHWSL]# subscription-manager attach\nYou are attempting to use a locale that is not installed.\nInstalled Product Current Status:\nProduct Name: Red Hat Enterprise Linux for x86_64\nStatus:       Subscribed\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\u003eRHWSL.exe\n[root@PC-NAME user]#\n```\n\n#### Run with command line\n```cmd\n\u003eRHWSL.exe run uname -r\n4.4.0-43-Microsoft\n```\n\n#### Run with command line with path translation\n```cmd\n\u003eRHWSL.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\u003eRHWSL.exe run useradd -m -g users -G wheel -s /bin/bash user\n\n\u003eRHWSL.exe config --default-user user\n\n\u003eRHWSL.exe\n[user@PC-NAME dir]$\n```\n\n#### Set \"Windows Terminal\" as default terminal\n```cmd\n\u003eRHWSL.exe config --default-term wt\n```\n\n#### How to uninstall instance\n```dos\n\u003eRHWSL.exe clean\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyosukes-dev%2FRHWSL","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyosukes-dev%2FRHWSL","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyosukes-dev%2FRHWSL/lists"}