|
| 1 | +# CentWSL |
| 2 | +CentOS on WSL (Windows 10 FCU or later) |
| 3 | +based on [wsldl](https://github.com/yuk7/wsldl) |
| 4 | + |
| 5 | +[](https://travis-ci.org/yuk7/CentWSL) |
| 6 | +[](https://github.com/yuk7/CentWSL/releases/latest) |
| 7 | +[](http://makeapullrequest.com) |
| 8 | + |
| 9 | + |
| 10 | +### [Download](https://github.com/yuk7/CentWSL/releases/latest) |
| 11 | + |
| 12 | + |
| 13 | +## Requirements |
| 14 | +* Windows 10 Fall Creators Update x64 or later. |
| 15 | +* Windows Subsystem for Linux feature is enabled. |
| 16 | + |
| 17 | +## Install |
| 18 | +#### 1. [Download](https://github.com/yuk7/CentWSL/releases/latest) installer zip |
| 19 | + |
| 20 | +#### 2. Extract all files in zip file to same directory |
| 21 | + |
| 22 | +#### 3.Run CentOS.exe to Extract rootfs and Register to WSL |
| 23 | +Exe filename is using to the instance name to register. |
| 24 | +If you rename it you can register with a diffrent name and have multiple installs. |
| 25 | + |
| 26 | + |
| 27 | +## How-to-Use(for Installed Instance) |
| 28 | +#### exe Usage |
| 29 | +```dos |
| 30 | +Usage : |
| 31 | + <no args> |
| 32 | + - Open a new shell with your default settings. |
| 33 | +
|
| 34 | + run <command line> |
| 35 | + - Run the given command line in that distro. Inherit current directory. |
| 36 | +
|
| 37 | + config [setting [value]] |
| 38 | + - `--default-user <user>`: Set the default user for this distro to <user> |
| 39 | + - `--default-uid <uid>`: Set the default user uid for this distro to <uid> |
| 40 | + - `--append-path <on|off>`: Switch of Append Windows PATH to $PATH |
| 41 | + - `--mount-drive <on|off>`: Switch of Mount drives |
| 42 | +
|
| 43 | + get [setting] |
| 44 | + - `--default-uid`: Get the default user uid in this distro |
| 45 | + - `--append-path`: Get on/off status of Append Windows PATH to $PATH |
| 46 | + - `--mount-drive`: Get on/off status of Mount drives |
| 47 | + - `--lxuid`: Get LxUID key for this distro |
| 48 | +
|
| 49 | + backup |
| 50 | + - Output backup.tar.gz to the current directory using tar command. |
| 51 | + |
| 52 | + clean |
| 53 | + - Uninstall the distro. |
| 54 | +
|
| 55 | + help |
| 56 | + - Print this usage message. |
| 57 | +``` |
| 58 | + |
| 59 | + |
| 60 | +#### How to uninstall instance |
| 61 | +```dos |
| 62 | +>CentOS.exe clean |
| 63 | +
|
| 64 | +``` |
0 commit comments