├── .github └── FUNDING.yml ├── .gitignore ├── .gitmodules ├── CONTRIBUTING.md ├── Command-Usage.md ├── Hidden-Options.md ├── How-to-Install.md ├── Known-issues.md ├── LICENSE ├── Other-Software ├── PhpStorm.md ├── fakeroot.md ├── index.md ├── jetbrains.md └── systemd.md ├── README.md ├── Using-wsldl.md ├── __sass └── custom │ └── custom.scss ├── _config.yml ├── _includes ├── body_gtag.html ├── default.html ├── head.html ├── head_custom.html ├── head_gtag.html └── title.html └── asset └── wsldl-logo.png /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: [yuk7] 4 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | _site/ 2 | .sass-cache/ 3 | .jekyll-cache/ 4 | .jekyll-metadata 5 | -------------------------------------------------------------------------------- /.gitmodules: -------------------------------------------------------------------------------- 1 | [submodule "module/pio"] 2 | path = module/pio 3 | url = https://github.com/Dreamer-Paul/Pio.git 4 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Contributing 3 | category: Contributing 4 | layout: default 5 | --- 6 | 7 | # Contributing 8 | 9 | We welcome contributions from everyone. 10 | 11 | You can make a pull request for a document or join as a member of the document team. 12 | 13 | If you're a member of the document team, it's okay to push Markdown files directly to the main branch. 14 | 15 | Please contact us for more information. 16 | -------------------------------------------------------------------------------- /Command-Usage.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Command Line Usage" 3 | --- 4 | # Command Line Usage 5 | #### exe Usage 6 | ``` 7 | Usage : 8 | 9 | - Open a new shell with your default settings. 10 | 11 | run 12 | - Run the given command line in that instance. Inherit current directory. 13 | 14 | runp 15 | - Run the given command line in that instance after converting its path. 16 | 17 | config [setting [value]] 18 | - `--default-user `: Set the default user of this instance to . 19 | - `--default-uid `: Set the default user uid of this instance to . 20 | - `--append-path `: Switch of Append Windows PATH to $PATH 21 | - `--mount-drive `: Switch of Mount drives 22 | - `--default-term `: Set default type of terminal window. 23 | 24 | get [setting] 25 | - `--default-uid`: Get the default user uid in this instance. 26 | - `--append-path`: Get true/false status of Append Windows PATH to $PATH. 27 | - `--mount-drive`: Get true/false status of Mount drives. 28 | - `--wsl-version`: Get the version os the WSL (1/2) of this instance. 29 | - `--default-term`: Get Default Terminal type of this instance launcher. 30 | - `--lxguid`: Get WSL GUID key for this instance. 31 | 32 | backup [contents] 33 | - `--tar`: Output backup.tar to the current directory. 34 | - `--reg`: Output settings registry file to the current directory. 35 | 36 | clean 37 | - Uninstall that instance. 38 | 39 | help 40 | - Print this usage message. 41 | ``` 42 | 43 | 44 | ### Launch instance 45 | ```cmd 46 | >{InstanceName}.exe 47 | [root@PC-NAME user]# 48 | ``` 49 | 50 | ### Run with command line 51 | ```cmd 52 | >{InstanceName}.exe run uname -r 53 | 4.4.0-43-Microsoft 54 | ``` 55 | 56 | ### Run with command line with path translation 57 | ```cmd 58 | >{InstanceName}.exe runp echo C:\Windows\System32\cmd.exe 59 | /mnt/c/Windows/System32/cmd.exe 60 | ``` 61 | 62 | ### Change Default User(id command required) 63 | ```cmd 64 | >{InstanceName}.exe config --default-user user 65 | 66 | >{InstanceName}.exe 67 | [user@PC-NAME dir]$ 68 | ``` 69 | 70 | ### Set "Windows Terminal" as default terminal 71 | ```cmd 72 | >{InstanceName}.exe config --default-term wt 73 | ``` 74 | 75 | ### How to uninstall instance 76 | ```cmd 77 | >{InstanceName}.exe clean 78 | 79 | ``` 80 | 81 | 82 | See [Hidden Options](Hidden-Options.md) for features not listed here. 83 | 84 | It is useful for automating installation and management. 85 | -------------------------------------------------------------------------------- /Hidden-Options.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Hidden Options" 3 | --- 4 | These are commands for distribution developers, so there is no need for documentation. 5 | # Hidden Options 6 | ## Common 7 | ### version 8 | ```cmd 9 | >{InstanceName}.exe version 10 | wsldl2, version 21071600 (amd64) 11 | https://git.io/wsldl 12 | ``` 13 | ### isregd 14 | ```cmd 15 | >{InstanceName}.exe isregd 16 | >echo %ERRORLEVEL% 17 | 0 18 | ``` 19 | Returns 0 if registered instance. 20 | 21 | ## Install 22 | ### Install Option (Silent) 23 | 1. Install Only 24 | ```cmd 25 | >{InstanceName}.exe install 26 | ``` 27 | 28 | 2. with tarball 29 | ```cmd 30 | >{InstanceName}.exe install {fileName} 31 | ``` 32 | 33 | 3. MS Compatibility (root mode install/silent) 34 | ```cmd 35 | >{InstanceName}.exe install --root 36 | ``` 37 | 38 | ## Installed 39 | ### Run with arg 40 | `{InstanceName}.exe -c {commands}` and `{InstanceName}.exe /c {commands}` for MS launcher compatibility. 41 | ### Silent Cleanup 42 | ```cmd 43 | >{InstanceName}.exe clean -y 44 | ``` 45 | -------------------------------------------------------------------------------- /How-to-Install.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "How to Install" 3 | --- 4 | # How-to-Install 5 | ## 🔧Install with any rootfs 6 | #### 1. [Download Launcher.exe](https://github.com/yuk7/wsldl/releases/latest) 7 | #### 2. Rename it for distribution name to register. 8 | (Ex: Rename to Arch.exe if you want to use "Arch" for the Instance name. Name shouldn't have space.) 9 | #### 3. Put your rootfs.tar.gz in same directory as exe (Installation directory) 10 | #### 4. Run exe to install. This process may take a few minutes. 11 | 12 | ## 🔗Use as a Launcher for already installed distribution 13 | #### 1. [Download Launcher.exe](https://github.com/yuk7/wsldl/releases/latest) 14 | #### 2. Rename it for registered instance name. 15 | Please check the registered instance name of the distribution with `wslconfig /l` command. 16 | (Ex: If the instance name is "Ubuntu-20.04", rename `Launcher.exe` to `Ubuntu-20.04.exe`) 17 | #### 4. Run exe to Launch instance or configuration. 18 | For details, please use help. (`{InstanceName}.exe --help`) 19 | 20 | Note: You can share your distribution including wsldl exe. 21 | -------------------------------------------------------------------------------- /Known-issues.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Known issues" 3 | --- 4 | ## Config command sometimes does not apply. 5 | 'config *' command does not apply in some cases.(issue [ArchWSL#7](https://github.com/yuk7/ArchWSL/issues/7)) 6 | 7 | In such situations, please reboot the computer or restart LxssManager service. 8 | 9 | ## Can install only on system drive 10 | WSL instances can be installed on system drive(C:) only. -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Attribution 4.0 International 2 | 3 | ======================================================================= 4 | 5 | Creative Commons Corporation ("Creative Commons") is not a law firm and 6 | does not provide legal services or legal advice. Distribution of 7 | Creative Commons public licenses does not create a lawyer-client or 8 | other relationship. Creative Commons makes its licenses and related 9 | information available on an "as-is" basis. Creative Commons gives no 10 | warranties regarding its licenses, any material licensed under their 11 | terms and conditions, or any related information. Creative Commons 12 | disclaims all liability for damages resulting from their use to the 13 | fullest extent possible. 14 | 15 | Using Creative Commons Public Licenses 16 | 17 | Creative Commons public licenses provide a standard set of terms and 18 | conditions that creators and other rights holders may use to share 19 | original works of authorship and other material subject to copyright 20 | and certain other rights specified in the public license below. The 21 | following considerations are for informational purposes only, are not 22 | exhaustive, and do not form part of our licenses. 23 | 24 | Considerations for licensors: Our public licenses are 25 | intended for use by those authorized to give the public 26 | permission to use material in ways otherwise restricted by 27 | copyright and certain other rights. Our licenses are 28 | irrevocable. Licensors should read and understand the terms 29 | and conditions of the license they choose before applying it. 30 | Licensors should also secure all rights necessary before 31 | applying our licenses so that the public can reuse the 32 | material as expected. Licensors should clearly mark any 33 | material not subject to the license. This includes other CC- 34 | licensed material, or material used under an exception or 35 | limitation to copyright. More considerations for licensors: 36 | wiki.creativecommons.org/Considerations_for_licensors 37 | 38 | Considerations for the public: By using one of our public 39 | licenses, a licensor grants the public permission to use the 40 | licensed material under specified terms and conditions. If 41 | the licensor's permission is not necessary for any reason--for 42 | example, because of any applicable exception or limitation to 43 | copyright--then that use is not regulated by the license. Our 44 | licenses grant only permissions under copyright and certain 45 | other rights that a licensor has authority to grant. Use of 46 | the licensed material may still be restricted for other 47 | reasons, including because others have copyright or other 48 | rights in the material. A licensor may make special requests, 49 | such as asking that all changes be marked or described. 50 | Although not required by our licenses, you are encouraged to 51 | respect those requests where reasonable. More considerations 52 | for the public: 53 | wiki.creativecommons.org/Considerations_for_licensees 54 | 55 | ======================================================================= 56 | 57 | Creative Commons Attribution 4.0 International Public License 58 | 59 | By exercising the Licensed Rights (defined below), You accept and agree 60 | to be bound by the terms and conditions of this Creative Commons 61 | Attribution 4.0 International Public License ("Public License"). To the 62 | extent this Public License may be interpreted as a contract, You are 63 | granted the Licensed Rights in consideration of Your acceptance of 64 | these terms and conditions, and the Licensor grants You such rights in 65 | consideration of benefits the Licensor receives from making the 66 | Licensed Material available under these terms and conditions. 67 | 68 | Section 1 -- Definitions. 69 | 70 | a. Adapted Material means material subject to Copyright and Similar 71 | Rights that is derived from or based upon the Licensed Material 72 | and in which the Licensed Material is translated, altered, 73 | arranged, transformed, or otherwise modified in a manner requiring 74 | permission under the Copyright and Similar Rights held by the 75 | Licensor. For purposes of this Public License, where the Licensed 76 | Material is a musical work, performance, or sound recording, 77 | Adapted Material is always produced where the Licensed Material is 78 | synched in timed relation with a moving image. 79 | 80 | b. Adapter's License means the license You apply to Your Copyright 81 | and Similar Rights in Your contributions to Adapted Material in 82 | accordance with the terms and conditions of this Public License. 83 | 84 | c. Copyright and Similar Rights means copyright and/or similar rights 85 | closely related to copyright including, without limitation, 86 | performance, broadcast, sound recording, and Sui Generis Database 87 | Rights, without regard to how the rights are labeled or 88 | categorized. For purposes of this Public License, the rights 89 | specified in Section 2(b)(1)-(2) are not Copyright and Similar 90 | Rights. 91 | 92 | d. Effective Technological Measures means those measures that, in the 93 | absence of proper authority, may not be circumvented under laws 94 | fulfilling obligations under Article 11 of the WIPO Copyright 95 | Treaty adopted on December 20, 1996, and/or similar international 96 | agreements. 97 | 98 | e. Exceptions and Limitations means fair use, fair dealing, and/or 99 | any other exception or limitation to Copyright and Similar Rights 100 | that applies to Your use of the Licensed Material. 101 | 102 | f. Licensed Material means the artistic or literary work, database, 103 | or other material to which the Licensor applied this Public 104 | License. 105 | 106 | g. Licensed Rights means the rights granted to You subject to the 107 | terms and conditions of this Public License, which are limited to 108 | all Copyright and Similar Rights that apply to Your use of the 109 | Licensed Material and that the Licensor has authority to license. 110 | 111 | h. Licensor means the individual(s) or entity(ies) granting rights 112 | under this Public License. 113 | 114 | i. Share means to provide material to the public by any means or 115 | process that requires permission under the Licensed Rights, such 116 | as reproduction, public display, public performance, distribution, 117 | dissemination, communication, or importation, and to make material 118 | available to the public including in ways that members of the 119 | public may access the material from a place and at a time 120 | individually chosen by them. 121 | 122 | j. Sui Generis Database Rights means rights other than copyright 123 | resulting from Directive 96/9/EC of the European Parliament and of 124 | the Council of 11 March 1996 on the legal protection of databases, 125 | as amended and/or succeeded, as well as other essentially 126 | equivalent rights anywhere in the world. 127 | 128 | k. You means the individual or entity exercising the Licensed Rights 129 | under this Public License. Your has a corresponding meaning. 130 | 131 | Section 2 -- Scope. 132 | 133 | a. License grant. 134 | 135 | 1. Subject to the terms and conditions of this Public License, 136 | the Licensor hereby grants You a worldwide, royalty-free, 137 | non-sublicensable, non-exclusive, irrevocable license to 138 | exercise the Licensed Rights in the Licensed Material to: 139 | 140 | a. reproduce and Share the Licensed Material, in whole or 141 | in part; and 142 | 143 | b. produce, reproduce, and Share Adapted Material. 144 | 145 | 2. Exceptions and Limitations. For the avoidance of doubt, where 146 | Exceptions and Limitations apply to Your use, this Public 147 | License does not apply, and You do not need to comply with 148 | its terms and conditions. 149 | 150 | 3. Term. The term of this Public License is specified in Section 151 | 6(a). 152 | 153 | 4. Media and formats; technical modifications allowed. The 154 | Licensor authorizes You to exercise the Licensed Rights in 155 | all media and formats whether now known or hereafter created, 156 | and to make technical modifications necessary to do so. The 157 | Licensor waives and/or agrees not to assert any right or 158 | authority to forbid You from making technical modifications 159 | necessary to exercise the Licensed Rights, including 160 | technical modifications necessary to circumvent Effective 161 | Technological Measures. For purposes of this Public License, 162 | simply making modifications authorized by this Section 2(a) 163 | (4) never produces Adapted Material. 164 | 165 | 5. Downstream recipients. 166 | 167 | a. Offer from the Licensor -- Licensed Material. Every 168 | recipient of the Licensed Material automatically 169 | receives an offer from the Licensor to exercise the 170 | Licensed Rights under the terms and conditions of this 171 | Public License. 172 | 173 | b. No downstream restrictions. You may not offer or impose 174 | any additional or different terms or conditions on, or 175 | apply any Effective Technological Measures to, the 176 | Licensed Material if doing so restricts exercise of the 177 | Licensed Rights by any recipient of the Licensed 178 | Material. 179 | 180 | 6. No endorsement. Nothing in this Public License constitutes or 181 | may be construed as permission to assert or imply that You 182 | are, or that Your use of the Licensed Material is, connected 183 | with, or sponsored, endorsed, or granted official status by, 184 | the Licensor or others designated to receive attribution as 185 | provided in Section 3(a)(1)(A)(i). 186 | 187 | b. Other rights. 188 | 189 | 1. Moral rights, such as the right of integrity, are not 190 | licensed under this Public License, nor are publicity, 191 | privacy, and/or other similar personality rights; however, to 192 | the extent possible, the Licensor waives and/or agrees not to 193 | assert any such rights held by the Licensor to the limited 194 | extent necessary to allow You to exercise the Licensed 195 | Rights, but not otherwise. 196 | 197 | 2. Patent and trademark rights are not licensed under this 198 | Public License. 199 | 200 | 3. To the extent possible, the Licensor waives any right to 201 | collect royalties from You for the exercise of the Licensed 202 | Rights, whether directly or through a collecting society 203 | under any voluntary or waivable statutory or compulsory 204 | licensing scheme. In all other cases the Licensor expressly 205 | reserves any right to collect such royalties. 206 | 207 | Section 3 -- License Conditions. 208 | 209 | Your exercise of the Licensed Rights is expressly made subject to the 210 | following conditions. 211 | 212 | a. Attribution. 213 | 214 | 1. If You Share the Licensed Material (including in modified 215 | form), You must: 216 | 217 | a. retain the following if it is supplied by the Licensor 218 | with the Licensed Material: 219 | 220 | i. identification of the creator(s) of the Licensed 221 | Material and any others designated to receive 222 | attribution, in any reasonable manner requested by 223 | the Licensor (including by pseudonym if 224 | designated); 225 | 226 | ii. a copyright notice; 227 | 228 | iii. a notice that refers to this Public License; 229 | 230 | iv. a notice that refers to the disclaimer of 231 | warranties; 232 | 233 | v. a URI or hyperlink to the Licensed Material to the 234 | extent reasonably practicable; 235 | 236 | b. indicate if You modified the Licensed Material and 237 | retain an indication of any previous modifications; and 238 | 239 | c. indicate the Licensed Material is licensed under this 240 | Public License, and include the text of, or the URI or 241 | hyperlink to, this Public License. 242 | 243 | 2. You may satisfy the conditions in Section 3(a)(1) in any 244 | reasonable manner based on the medium, means, and context in 245 | which You Share the Licensed Material. For example, it may be 246 | reasonable to satisfy the conditions by providing a URI or 247 | hyperlink to a resource that includes the required 248 | information. 249 | 250 | 3. If requested by the Licensor, You must remove any of the 251 | information required by Section 3(a)(1)(A) to the extent 252 | reasonably practicable. 253 | 254 | 4. If You Share Adapted Material You produce, the Adapter's 255 | License You apply must not prevent recipients of the Adapted 256 | Material from complying with this Public License. 257 | 258 | Section 4 -- Sui Generis Database Rights. 259 | 260 | Where the Licensed Rights include Sui Generis Database Rights that 261 | apply to Your use of the Licensed Material: 262 | 263 | a. for the avoidance of doubt, Section 2(a)(1) grants You the right 264 | to extract, reuse, reproduce, and Share all or a substantial 265 | portion of the contents of the database; 266 | 267 | b. if You include all or a substantial portion of the database 268 | contents in a database in which You have Sui Generis Database 269 | Rights, then the database in which You have Sui Generis Database 270 | Rights (but not its individual contents) is Adapted Material; and 271 | 272 | c. You must comply with the conditions in Section 3(a) if You Share 273 | all or a substantial portion of the contents of the database. 274 | 275 | For the avoidance of doubt, this Section 4 supplements and does not 276 | replace Your obligations under this Public License where the Licensed 277 | Rights include other Copyright and Similar Rights. 278 | 279 | Section 5 -- Disclaimer of Warranties and Limitation of Liability. 280 | 281 | a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE 282 | EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS 283 | AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF 284 | ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, 285 | IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, 286 | WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR 287 | PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, 288 | ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT 289 | KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT 290 | ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. 291 | 292 | b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE 293 | TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, 294 | NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, 295 | INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, 296 | COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR 297 | USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN 298 | ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR 299 | DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR 300 | IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. 301 | 302 | c. The disclaimer of warranties and limitation of liability provided 303 | above shall be interpreted in a manner that, to the extent 304 | possible, most closely approximates an absolute disclaimer and 305 | waiver of all liability. 306 | 307 | Section 6 -- Term and Termination. 308 | 309 | a. This Public License applies for the term of the Copyright and 310 | Similar Rights licensed here. However, if You fail to comply with 311 | this Public License, then Your rights under this Public License 312 | terminate automatically. 313 | 314 | b. Where Your right to use the Licensed Material has terminated under 315 | Section 6(a), it reinstates: 316 | 317 | 1. automatically as of the date the violation is cured, provided 318 | it is cured within 30 days of Your discovery of the 319 | violation; or 320 | 321 | 2. upon express reinstatement by the Licensor. 322 | 323 | For the avoidance of doubt, this Section 6(b) does not affect any 324 | right the Licensor may have to seek remedies for Your violations 325 | of this Public License. 326 | 327 | c. For the avoidance of doubt, the Licensor may also offer the 328 | Licensed Material under separate terms or conditions or stop 329 | distributing the Licensed Material at any time; however, doing so 330 | will not terminate this Public License. 331 | 332 | d. Sections 1, 5, 6, 7, and 8 survive termination of this Public 333 | License. 334 | 335 | Section 7 -- Other Terms and Conditions. 336 | 337 | a. The Licensor shall not be bound by any additional or different 338 | terms or conditions communicated by You unless expressly agreed. 339 | 340 | b. Any arrangements, understandings, or agreements regarding the 341 | Licensed Material not stated herein are separate from and 342 | independent of the terms and conditions of this Public License. 343 | 344 | Section 8 -- Interpretation. 345 | 346 | a. For the avoidance of doubt, this Public License does not, and 347 | shall not be interpreted to, reduce, limit, restrict, or impose 348 | conditions on any use of the Licensed Material that could lawfully 349 | be made without permission under this Public License. 350 | 351 | b. To the extent possible, if any provision of this Public License is 352 | deemed unenforceable, it shall be automatically reformed to the 353 | minimum extent necessary to make it enforceable. If the provision 354 | cannot be reformed, it shall be severed from this Public License 355 | without affecting the enforceability of the remaining terms and 356 | conditions. 357 | 358 | c. No term or condition of this Public License will be waived and no 359 | failure to comply consented to unless expressly agreed to by the 360 | Licensor. 361 | 362 | d. Nothing in this Public License constitutes or may be interpreted 363 | as a limitation upon, or waiver of, any privileges and immunities 364 | that apply to the Licensor or You, including from the legal 365 | processes of any jurisdiction or authority. 366 | 367 | ======================================================================= 368 | 369 | Creative Commons is not a party to its public 370 | licenses. Notwithstanding, Creative Commons may elect to apply one of 371 | its public licenses to material it publishes and in those instances 372 | will be considered the “Licensor.” The text of the Creative Commons 373 | public licenses is dedicated to the public domain under the CC0 Public 374 | Domain Dedication. Except for the limited purpose of indicating that 375 | material is shared under a Creative Commons public license or as 376 | otherwise permitted by the Creative Commons policies published at 377 | creativecommons.org/policies, Creative Commons does not authorize the 378 | use of the trademark "Creative Commons" or any other trademark or logo 379 | of Creative Commons without its prior written consent including, 380 | without limitation, in connection with any unauthorized modifications 381 | to any of its public licenses or any other arrangements, 382 | understandings, or agreements concerning use of licensed material. For 383 | the avoidance of doubt, this paragraph does not form part of the 384 | public licenses. 385 | 386 | Creative Commons may be contacted at creativecommons.org. -------------------------------------------------------------------------------- /Other-Software/PhpStorm.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: PhpStorm 3 | grand_parent: "Other Software" 4 | parent: "Jetbrains IDEs" 5 | #nav_order: 6 | --- 7 | 8 | # How to use a custom WSL distribution with PhpStorm 9 | 10 | 1. Follow the installation instructions ([here](https://github.com/yuk7/wsldl#install-with-any-rootfs)) **BUT** rename the launcher the same as one of this 11 | ``` 12 | // Found in AppData\Roaming\JetBrains\PhpStorm{YOUR_VERSION}\options\wsl.distributions.xml 13 | debian.exe 14 | kali.exe 15 | opensuse-42.exe 16 | sles-12.exe 17 | sles-15.exe 18 | openSUSE-Leap-15.exe 19 | ubuntu.exe 20 | ubuntu1604.exe 21 | ubuntu1804.exe 22 | wlinux.exe 23 | pengwin.exe 24 | wle.exe 25 | Arch.exe 26 | openSUSE-Leap-15-1.exe 27 | ``` 28 | 29 | The reason for this is that all paths for WSL executables are hard coded. So even if you add a custom distribution in `wsl.distributions.xml`, it will not work. 30 | 31 | **The name of the executable is not obligatory the same as the ditribution it run !** 32 | You can install Ubuntu with a launcher named `debian.exe` and it will work. 33 | 34 | 2. Move the executable in `C:\Users\{USER}\AppData\Local\Microsoft\WindowsApps` 35 | 3. Open or reopen Phpstorm and if all is good you can use WSL as an interpreter for PHP and nodejs 36 | 37 | # Another solution 38 | 39 | Another solution can be found [here](https://www.jetbrains.com/help/ruby/configuring-remote-interpreters-using-wsl.html#custom_wsl). 40 | 41 | Note that this solution seems to not work for everyone. 42 | -------------------------------------------------------------------------------- /Other-Software/fakeroot.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Fakeroot 3 | parent: "Other Software" 4 | nav_order: 2 5 | --- 6 | 7 | # Use fakeroot 8 | Fakeroot uses SYSV IPC by default. 9 | 10 | WSL1 does not support SYSV IPC call. 11 | 12 | ## Ubuntu or Debian or Fedora,etc... 13 | fakeroot-tcp is included in package. 14 | 15 | switch to use it. 16 | ```bash 17 | # Ubuntu/Debian 18 | update-alternatives --set fakeroot /usr/bin/fakeroot-tcp 19 | ``` 20 | ```bash 21 | # Fedora 22 | alternatives --config fakeroot 23 | ``` 24 | 25 | ## Others (Build manually) 26 | configure with ```--with-ipc=tcp``` and build it. -------------------------------------------------------------------------------- /Other-Software/index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Other Software" 3 | layout: default 4 | nav_order: 6 5 | has_children: true 6 | permalink: /Other-Software 7 | --- 8 | 9 | # Combine with Other Software 10 | 11 | [fakeroot](fakeroot.md) 12 | 13 | [systemd](systemd.md) 14 | 15 | [Jetbrains IDEs](jetbrains.md) 16 | -------------------------------------------------------------------------------- /Other-Software/jetbrains.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Jetbrains IDEs" 3 | parent: "Other Software" 4 | has_children: true 5 | nav_order: 4 6 | --- 7 | 8 | # Jetbrains IDEs 9 | You can use `wsl.distributions.xml` file to configure Jetbrains IDEs interpreter. 10 | 11 | `config\options\wsl.distributions.xml` 12 | 13 | Example: 14 | ```xml 15 | 16 | Arch 17 | Arch 18 | c:/linux/arch.exe 19 | Arch 20 | 21 | ``` 22 | 23 | For more details, check the link below. 24 | 25 | https://www.jetbrains.com/help/pycharm/using-wsl-as-a-remote-interpreter.html#custom-distribution 26 | -------------------------------------------------------------------------------- /Other-Software/systemd.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Systemd 3 | parent: "Other Software" 4 | nav_order: 3 5 | --- 6 | 7 | ## systemd/systemctl 8 | WSL does not support systemd. 9 | 10 | But if you use WSL2, you can use bottle and run systemd completely. 11 | 12 | #### subsystemctl 13 | https://github.com/sorah/subsystemctl 14 | 15 | #### genie 16 | https://github.com/arkane-systems/genie 17 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | --- 2 | layout: default 3 | title: Home 4 | nav_order: 1 5 | description: "The beginning of the world" 6 | permalink: / 7 | --- 8 | 9 | # wsldl documentation 10 | Welcome to wsldl documentation! 11 | 12 | wsldl is a versatile and advanced WSL/WSL2 launcher and installer written in Go. It can be used to install any rootfs package or act as a launcher to an existing installed distribution. 13 | 14 | Use the links below to learn more about wsldl. 15 | 16 | [Project List Using wsldl](Using-wsldl.md) 17 | 18 | [How to Install](How-to-Install.md) 19 | 20 | [Command Line Usage](Command-Usage.md) 21 | 22 | [Known issues](Known-issues.md) 23 | 24 | [Combine with Other software](Other-Software/index.md) 25 | 26 | [Contributing to this document](CONTRIBUTING.md) 27 | -------------------------------------------------------------------------------- /Using-wsldl.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Project List Using wsldl" 3 | --- 4 | # Project List Using wsldl 5 | List of projects using the official build of wsldl. 6 | 7 | ## Distros 8 | [AlmaLinux](https://github.com/amithgeorge/AlmaLinux-WSL2) (by [amithgeoge](https://github.com/amithgeorge)) 9 | 10 | [Alpine Linux](https://github.com/yuk7/AlpineWSL) (by [yuk7](https://github.com/yuk7)) 11 | 12 | [Alpine Linux Edge (Rolling Release)](https://github.com/sileshn/AlpineWSL2) (by [SileshNair](https://github.com/sileshn)) 13 | 14 | [Alpine Linux with Git-LFS and Sphinx](https://github.com/binarylandscapes/AlpineWSL) (by [binarylandscapes](https://github.com/binarylandscapes)) 15 | 16 | [Amazon Linux 2](https://github.com/yosukes-dev/AmazonWSL) (by [yosukes-dev](https://github.com/yosukes-dev)) 17 | 18 | [Arch Linux](https://github.com/yuk7/ArchWSL) (by [yuk7](https://github.com/yuk7)) 19 | 20 | [Arch Linux](https://github.com/sileshn/ArchWSL2) (by [SileshNair](https://github.com/sileshn)) 21 | 22 | [Artix Linux](https://github.com/hdk5/ArtixWSL) (by [hdk5](https://github.com/hdk5)) 23 | 24 | [CentOS](https://github.com/mishamosher/CentOS-WSL) (by [mishamosher](https://github.com/mishamosher)) 25 | 26 | [Chimera Linux](https://github.com/tranzystorekk/ChimeraWSL) (by [tranzystorekk](https://github.com/tranzystorekk)) 27 | 28 | [Clear Linux](https://github.com/wight554/ClearWSL/) (by [wight554](https://github.com/wight554)) 29 | 30 | [Deepin](https://github.com/justforlxz/DeepinWSL/) (by [justforlxz](https://github.com/justforlxz)) 31 | 32 | [Devuan Linux](https://github.com/VPraharsha3/DevuanWSL) (by [VPraharsha03](https://github.com/VPraharsha03)) 33 | 34 | [ElementaryOS](https://github.com/sileshn/ElementaryWSL2) (by [SileshNair](https://github.com/sileshn)) 35 | 36 | [EndeavourOS](https://github.com/sileshn/EndeavourOSWSL2) (by [SileshNair](https://github.com/sileshn)) 37 | 38 | [Fedora](https://github.com/yosukes-dev/FedoraWSL) (by [yosukes-dev](https://github.com/yosukes-dev)) 39 | 40 | [Funtoo](https://github.com/rescenic/FuntooWSL) (by [rescenic](https://github.com/rescenic)) 41 | 42 | [Gentoo](https://github.com/VPraharsha03/GentooWSL2) (by [VPraharsha03](https://github.com/VPraharsha03)) 43 | 44 | [Gentoo](https://github.com/sileshn/GentooWSL2) (by [SileshNair](https://github.com/sileshn)) 45 | 46 | [Linux Mint](https://github.com/sileshn/LinuxmintWSL2) (by [SileshNair](https://github.com/sileshn)) 47 | 48 | [Manjaro](https://github.com/sileshn/ManjaroWSL2) (by [SileshNair](https://github.com/sileshn)) 49 | 50 | [Red hat(UBI)](https://github.com/yosukes-dev/RHWSL) (by [yosukes-dev](https://github.com/yosukes-dev)) 51 | 52 | [Rhino Linux](https://github.com/sileshn/RhinoLinuxWSL2) (by [SileshNair](https://github.com/sileshn)) 53 | 54 | [Rocky Linux](https://github.com/mishamosher/RL-WSL) (by [mishamosher](https://github.com/mishamosher)) 55 | 56 | [Slackware](https://github.com/sileshn/SlackwareWSL2) (by [SileshNair](https://github.com/sileshn)) 57 | 58 | [Solus](https://github.com/sileshn/SolusWSL2) (by [SileshNair](https://github.com/sileshn)) 59 | 60 | [Void Linux (glibc and mucl variants)](https://github.com/am11/VoidWSL) (by [am11](https://github.com/am11)) 61 | -------------------------------------------------------------------------------- /__sass/custom/custom.scss: -------------------------------------------------------------------------------- 1 | 2 | -------------------------------------------------------------------------------- /_config.yml: -------------------------------------------------------------------------------- 1 | title: "Wsldl official documentation" 2 | description: "A Wsldl for documentation" 3 | footer_content: "Copyright © 2020 Wsldl-pg Documentation Team. Distributed by Creative Commons Attribution 4.0 International License." 4 | logo: "/asset/wsldl-logo.png" 5 | 6 | remote_theme: "pmarsceill/just-the-docs" 7 | color_scheme: "dark" 8 | search_enabled: true 9 | search: 10 | rel_url: true 11 | button: true 12 | baseurl: "/docs" 13 | url: "https://wsldl-pg.github.io" 14 | aux_links: 15 | " See GitHub": 16 | - "//github.com/wsldl-pg/docs" 17 | aux_links_new_tab: true 18 | 19 | permalink: pretty 20 | exclude: [ "node_modules/", "*.gemspec", "*.gem", "Gemfile", "Gemfile.lock", "package.json", "package-lock.json", "script/", "lib/", "bin/", "Rakefile", "docs/tests/", "module/" ] 21 | 22 | heading_anchors: true 23 | 24 | back_to_top: true 25 | back_to_top_text: "Back to top" 26 | 27 | gh_edit_link: true 28 | gh_edit_link_text: "Edit this page on GitHub" 29 | gh_edit_repository: "https://github.com/wsldl-pg/docs" 30 | gh_edit_branch: "main" 31 | gh_edit_view_mode: "tree" 32 | 33 | #ga_tracking: UA-1234567-89 34 | #ga_tracking_anonymize_ip: true 35 | 36 | plugins: 37 | - jekyll-seo-tag 38 | - jekyll-sitemap 39 | 40 | kramdown: 41 | syntax_highlighter_opts: 42 | block: 43 | line_numbers: false 44 | 45 | compress_html: 46 | clippings: all 47 | comments: all 48 | endings: all 49 | startings: [] 50 | blanklines: false 51 | profile: false 52 | # ignore: 53 | # envs: all 54 | -------------------------------------------------------------------------------- /_includes/body_gtag.html: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | -------------------------------------------------------------------------------- /_includes/default.html: -------------------------------------------------------------------------------- 1 | --- 2 | layout: table_wrappers 3 | --- 4 | 5 | 6 | 7 | 8 | {% include head.html %} 9 | 10 | {% include body_gtag.html %} 11 | 12 | 13 | Link 14 | 15 | 16 | 17 | 18 | 19 | Search 20 | 21 | 22 | 23 | 24 | 25 | Menu 26 | 27 | 28 | 29 | 30 | 31 | Expand 32 | 33 | 34 | 35 | 36 | 37 | Document 38 | 39 | 40 | 41 | 42 | 43 | 44 | 73 |
74 |
75 | {% if site.search_enabled != false %} 76 | 83 | {% endif %} 84 | {% include header_custom.html %} 85 | {% if site.aux_links %} 86 | 101 | {% endif %} 102 |
103 |
104 | {% unless page.url == "/" %} 105 | {% if page.parent %} 106 | {%- for node in pages_list -%} 107 | {%- if node.parent == nil -%} 108 | {%- if page.parent == node.title or page.grand_parent == node.title -%} 109 | {%- assign first_level_url = node.url | absolute_url -%} 110 | {%- endif -%} 111 | {%- if node.has_children -%} 112 | {%- assign children_list = pages_list | where: "parent", node.title -%} 113 | {%- for child in children_list -%} 114 | {%- if page.url == child.url or page.parent == child.title -%} 115 | {%- assign second_level_url = child.url | absolute_url -%} 116 | {%- endif -%} 117 | {%- endfor -%} 118 | {%- endif -%} 119 | {%- endif -%} 120 | {%- endfor -%} 121 | 132 | {% endif %} 133 | {% endunless %} 134 |
135 | {% if site.heading_anchors != false %} 136 | {% include vendor/anchor_headings.html html=content beforeHeading="true" anchorBody="" anchorClass="anchor-heading" anchorAttrs="aria-labelledby=\"%html_id%\"" %} 137 | {% else %} 138 | {{ content }} 139 | {% endif %} 140 | 141 | {% if page.has_children == true and page.has_toc != false %} 142 |
143 |

Table of contents

144 |
    145 | {%- assign children_list = pages_list | where: "parent", page.title | where: "grand_parent", page.parent -%} 146 | {% for child in children_list %} 147 |
  • 148 | {{ child.title }}{% if child.summary %} - {{ child.summary }}{% endif %} 149 |
  • 150 | {% endfor %} 151 |
152 | {% endif %} 153 | 154 | {% capture footer_custom %} 155 | {%- include footer_custom.html -%} 156 | {% endcapture %} 157 | {% if footer_custom != "" or site.last_edit_timestamp or site.gh_edit_link %} 158 |
159 |
160 | {% if site.back_to_top %} 161 |

{{ site.back_to_top_text }}

162 | {% endif %} 163 | 164 | {{ footer_custom }} 165 | 166 | {% if site.last_edit_timestamp or site.gh_edit_link %} 167 |
168 | {% if site.last_edit_timestamp and site.last_edit_time_format and page.last_modified_date %} 169 |

170 | Page last modified: {{ page.last_modified_date | date: site.last_edit_time_format }}. 171 |

172 | {% endif %} 173 | {% if 174 | site.gh_edit_link and 175 | site.gh_edit_link_text and 176 | site.gh_edit_repository and 177 | site.gh_edit_branch and 178 | site.gh_edit_view_mode 179 | %} 180 |

181 | {{ site.gh_edit_link_text }} 182 |

183 | {% endif %} 184 |
185 | {% endif %} 186 |
187 | {% endif %} 188 | 189 |
190 |
191 | 192 | {% if site.search_enabled != false %} 193 | {% if site.search.button %} 194 | 195 | 196 | 197 | {% endif %} 198 | 199 |
200 | {% endif %} 201 |
202 | 203 | 204 | -------------------------------------------------------------------------------- /_includes/head.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | {% include head_gtag.html %} 6 | 7 | {% unless site.plugins contains "jekyll-seo-tag" %} 8 | {{ page.title }} - {{ site.title }} 9 | 10 | {% if page.description %} 11 | 12 | {% endif %} 13 | {% endunless %} 14 | 15 | 16 | 17 | 18 | 19 | {% if site.ga_tracking != nil %} 20 | 21 | 28 | 29 | {% endif %} 30 | 31 | {% if site.search_enabled != false %} 32 | 33 | {% endif %} 34 | 35 | 36 | 37 | 38 | {% seo %} 39 | 40 | {% include head_custom.html %} 41 | 42 | -------------------------------------------------------------------------------- /_includes/head_custom.html: -------------------------------------------------------------------------------- 1 | 35 | -------------------------------------------------------------------------------- /_includes/head_gtag.html: -------------------------------------------------------------------------------- 1 | 2 | 7 | 8 | 9 | 10 | 16 | -------------------------------------------------------------------------------- /_includes/title.html: -------------------------------------------------------------------------------- 1 | Wsldl Documentation 2 | -------------------------------------------------------------------------------- /asset/wsldl-logo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/wsldl-pg/docs/bb8f71a89e1458734dcb01dfed8d6ebf0cc05c3d/asset/wsldl-logo.png --------------------------------------------------------------------------------