diff --git a/WSL/build-custom-distro.md b/WSL/build-custom-distro.md index d54348b3..5a44c03a 100644 --- a/WSL/build-custom-distro.md +++ b/WSL/build-custom-distro.md @@ -49,9 +49,11 @@ defaultUid = 1000 defaultName = my-distro [shortcut] +enabled = true icon = /usr/lib/wsl/my-icon.ico [windowsterminal] +enabled = true ProfileTemplate = /usr/lib/wsl/terminal-profile.json ``` @@ -63,7 +65,9 @@ WSL distribution file configuration options: | `oobe.defaultUid` | integer | `` | The default UID that the distribution starts with. This is useful when the `oobe.command` script creates a new user. | | `oobe.defaultName`| string | `` | The default name that the distribution is registered under. This default name can be replaced with the command: `wsl.exe --install --name ` | | `shortcut.icon` | string | The default WSL icon | The icon in the start menu shortcut for the distribution. Must be in `.ico` format with a maximum size of `10MB` | -| `windowsterminal.profileTemplate` | string | Path to a terminal template file | The JSON template to generate a Windows Terminal profile for this distribution. | +| `shortcut.enabled` | boolean | true | Whether a start menu shortcut should be created when the distribution is installed. | +| `windowsterminal.profileTemplate` | string | `` | The JSON template to generate a Windows Terminal profile for this distribution. | +| `windowsterminal.enabled` | boolean | true | Whether a terminal profile should be created when the distribution is installed. If `profileTemplate` is not set, a default profile will be generated. | You need to create an out of box experience (OOBE) first run experience for the distribution. Below is a sample bash script that you can use. This script assumes that `oobe.defaultUid` is set to `1000`: