https://github.com/yosukes-dev/RHWSL
Red hat UBI as a WSL Instance. Supports multiple install.
https://github.com/yosukes-dev/RHWSL
redhat redhat-enterprise-linux wsl
Last synced: 8 months ago
JSON representation
Red hat UBI as a WSL Instance. Supports multiple install.
- Host: GitHub
- URL: https://github.com/yosukes-dev/RHWSL
- Owner: yosukes-dev
- License: other
- Archived: true
- Created: 2020-02-25T12:36:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-01-24T07:28:04.000Z (almost 3 years ago)
- Last Synced: 2024-11-04T20:42:25.272Z (about 1 year ago)
- Topics: redhat, redhat-enterprise-linux, wsl
- Language: Makefile
- Homepage:
- Size: 1.52 MB
- Stars: 129
- Watchers: 10
- Forks: 20
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Awesome-WSL - RHWSL - Red Hat Universal Base Image as a WSL distro. If you have a Red Hat Subscription, you can register and subscribe the system and use it as RHEL. ![github project][githublogo] (Unofficial Distributions / 10. GUI Apps)
README
# RHWSL (Red hat UBI on WSL)
Red hat redistributable Standard UBI on WSL (Windows 10 Windows 10 FCU or later)
based on [wsldl](https://github.com/yuk7/wsldl)
[](https://circleci.com/gh/yosukes-dev/RHWSL)
[](https://github.com/yosukes-dev/RHWSL/releases)
[](http://makeapullrequest.com)
### [Download](https://github.com/yosukes-dev/RHWSL/releases)
## Requirements
* Windows 10 Fall Creators Update x64 or later.
* Windows Subsystem for Linux feature is enabled.
## Install
#### 1. [Download](https://github.com/yosukes-dev/RHWSL/releases) installer zip
#### 2. Extract all files in zip file to same directory
#### 3.Run RHWSL.exe to Extract rootfs and Register to WSL
Exe filename is using to the instance name to register.
If you rename it you can register with a diffrent name and have multiple installs.
## (Option)
- If you want to use WSL2, convert it with the following command.
```dos
wsl --set-version RHWSL 2
```
## Subscription Manager
- The rootfs included in the release file is the redistributable Standard __"Universal Base Image"__.
__However, you can register as usual using subscription-manager and use the RHEL repositories.__
```sh
[root@ RHWSL]# subscription-manager register
You are attempting to use a locale that is not installed.
Registering to: subscription.rhsm.redhat.com:443/subscription
Username:
Password:
The system has been registered with ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
The registered system name is:
[root@ RHWSL]# subscription-manager attach
You are attempting to use a locale that is not installed.
Installed Product Current Status:
Product Name: Red Hat Enterprise Linux for x86_64
Status: Subscribed
```
## How-to-Use(for Installed Instance)
#### exe Usage
```dos
Usage :
- Open a new shell with your default settings.
run
- Run the given command line in that distro. Inherit current directory.
runp
- Run the path translated command line in that distro.
config [setting [value]]
- `--default-user `: Set the default user for this distro to
- `--default-uid `: Set the default user uid for this distro to
- `--append-path `: Switch of Append Windows PATH to $PATH
- `--mount-drive `: Switch of Mount drives
- `--default-term `: Set default terminal window
get [setting]
- `--default-uid`: Get the default user uid in this distro
- `--append-path`: Get on/off status of Append Windows PATH to $PATH
- `--mount-drive`: Get on/off status of Mount drives
- `--wsl-version`: Get WSL Version 1/2 for this distro
- `--default-term`: Get Default Terminal for this distro launcher
- `--lxguid`: Get WSL GUID key for this distro
backup [contents]
- `--tgz`: Output backup.tar.gz to the current directory using tar command
- `--reg`: Output settings registry file to the current directory
clean
- Uninstall the distro.
help
- Print this usage message.
```
#### Just Run exe
```cmd
>RHWSL.exe
[root@PC-NAME user]#
```
#### Run with command line
```cmd
>RHWSL.exe run uname -r
4.4.0-43-Microsoft
```
#### Run with command line with path translation
```cmd
>RHWSL.exe runp echo C:\Windows\System32\cmd.exe
/mnt/c/Windows/System32/cmd.exe
```
#### Change Default User(id command required)
The following is an example of adding a user to the "users" and "wheel" groups and setting it as the default user
_Note: Replace `user` with your chosen user name._
```cmd
>RHWSL.exe run useradd -m -g users -G wheel -s /bin/bash user
>RHWSL.exe config --default-user user
>RHWSL.exe
[user@PC-NAME dir]$
```
#### Set "Windows Terminal" as default terminal
```cmd
>RHWSL.exe config --default-term wt
```
#### How to uninstall instance
```dos
>RHWSL.exe clean
```