From 35fac6773669d3a1c37e6a8156098fd921799ecc Mon Sep 17 00:00:00 2001 From: tituspijean Date: Sat, 23 Apr 2022 23:22:00 +0200 Subject: [PATCH 1/2] Add installation tutorial on WSL --- images/wsl.png | Bin 0 -> 13589 bytes pages/02.administer/10.install/install.md | 163 +++++++++++++++++++++- 2 files changed, 160 insertions(+), 3 deletions(-) create mode 100644 images/wsl.png diff --git a/images/wsl.png b/images/wsl.png new file mode 100644 index 0000000000000000000000000000000000000000..2354305723e4c8aab823d38f2388c7d98b6fca6e GIT binary patch literal 13589 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 /etc/apt/sources.list.d/wsl-translinux.list +# Install Genie +sudo apt update +sudo apt install -y systemd-genie +``` + +## Install YunoHost + +```bash +# In WSL +# Let's switch to the root user, if you were not already +sudo su +# Initialize the Genie bottle to have systemd running +genie -s +# Your hostname should have been appended with "-wsl" +# Install YunoHost +curl https://install.yunohost.org | bash -s -- -a +``` + +### Access the command line + +Always call `genie -s` while starting your distro. + +`wsl -d YunoHost -e genie -s` + +## Backup and restore the distro +### Make your first distro backup +As said before, there is no rollback capability. So let's export your fresh distro. :slight_smile: In PowerShell: + +``` +cd ~ +wsl --export YunoHost .\WSL\YunoHost.tar.gz +``` + +### In case of crash, delete and restore the whole distro + +``` +cd ~ +wsl --unregister YunoHost +wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 +``` +{% endif %} {% if vps_ynh %} ## YunoHost VPS providers @@ -485,11 +614,12 @@ curl https://install.yunohost.org | bash {% endif %} - ## [fa=cog /] Proceed with the initial configuration !!! If you are in the process of restoring a server using a YunoHost backup, you should skip this step and instead [restore the backup instead of the postinstall step](/backup#restoring-during-the-postinstall). +{% if not wsl %} + [ui-tabs position="top-left" active="0" theme="lite"] [ui-tab title="From the web interface"] {%if at_home %} @@ -500,7 +630,9 @@ In an internet browser, type **{% if internetcube %}`https://internetcube.local` You can perform the initial configuration with the web interface by typing in the adress bar of your web browser **the public IP address of your server**. Typically, your VPS provider should have provided you with the IP of the server. {% endif %} -! During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). For now, you should add a security exception to accept the current certificate. (Though, PLEASE, do not take the habit of blindly accepting this kind of security alert!) +{% endif %} + +! During the first visit, you will very likely encounter a security warning related to the certificate used by the server. For now, your server uses a self-signed certificate. {% if not wsl %}You will later be able to add a certificate automatically recognized by web browsers as described in the [certificate documentation](/certificate). {% endif %} For now, you should add a security exception to accept the current certificate. (Though, PLEASE, do not take the habit of blindly accepting this kind of security alert!) {% if not internetcube %} You should then land on this page : @@ -528,12 +660,33 @@ You can also perform the postinstallation with the command `yunohost tools posti This will be the domain used by your server's users to access the **authentication portal**. You can later add other domains, and change which one is the main domain if needed. +{% if not wsl %} + * If you're new to self-hosting and do not already have a domain name, we recommend using a **.nohost.me** / **.noho.st** / **.ynh.fr** (e.g. `homersimpson.nohost.me`). Provided that it's not already taken, the domain will be configured automatically and you won't need any further configuration step. Please note that the downside is that you won't have full-control over the DNS configuration. * If you already own a domain name, you probably want to use it here. You will later need to configure DNS records as explained [here](/dns_config). !!! Yes, you *have to* configure a domain name. If you don't have any domain name and don't want a **.nohost.me** / **.noho.st** / **.ynh.fr** either, you can set up a dummy domain such as `yolo.test` and tweak your `/etc/hosts` file such that this dummy domain points to the appropriate IP, as explained [here](/dns_local_network)). +{% else %} + +You will have to choose a fake domain, since it will not be accessible from outside. +For example, `ynh.wsl`. The tricky part is advertising this domain to your host. + +Alter your `C:\Windows\System32\drivers\etc\hosts` file. You should have a line starting by `::1`, update it or add it if needed to get: + +``` +::1 ynh.wsl localhost +``` + +If you want to create subdomains, do not forget to add them in the `hosts` file too: + +``` +::1 ynh.wsl subdomain.ynh.wsl localhost +``` + +{% endif %} + ##### [fa=key /] Administration password This password will be used to access to your server's administration interface. You will also use it to connect [via **SSH**](/ssh) or [**SFTP**](/filezilla). In general terms, this is your **system's key**, choose it carefully! @@ -570,6 +723,10 @@ TODO : copypasta an actual shell session will all info asked etc.. ## [fa=stethoscope /] Run the initial diagnosis +{% if wsl %} +! Reminder: YunoHost in WSL will likely not be reachable from outside, and real domains and certificates won't be able to be assigned to it. +{% endif %} + The diagnosis system is meant to provide an easy way to validate that all critical aspects of your server are properly configured - and guide you in how to fix issues. The diagnosis will run twice a day and send an alert if issues are detected. !!! N.B. : **don't run away** ! The first time you run the diagnosis, it is quite expected to see a bunch of yellow/red alerts because you typically need to [configure DNS records](/dns_config) (if not using a `.nohost.me`/`noho.st`/`ynh.fr` domain), add a swapfile if not enough ram {% if at_home %} and/or [port forwarding](/isp_box_config){% endif %}. From 2628ed451cdd078cc18580bd75a1f0d63beb6f3a Mon Sep 17 00:00:00 2001 From: tituspijean Date: Sun, 14 Aug 2022 16:58:59 +0200 Subject: [PATCH 2/2] WSL tutorial cleanup and bullseye-ready --- pages/02.administer/10.install/install.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/pages/02.administer/10.install/install.md b/pages/02.administer/10.install/install.md index e70fa768..f630bd96 100644 --- a/pages/02.administer/10.install/install.md +++ b/pages/02.administer/10.install/install.md @@ -213,11 +213,13 @@ However, community images exist and are available on Docker Hub: {% if wsl %} ## Introduction -WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless. Docker for Windows can now rely on WSL instead of Hyper-V, for example. +WSL is a nice feature of Windows 10, making Linux pseudo-distributions available through command line. Let's say pseudo, because even though they are not really like virtual machines, they rely on virtualization capacities that make their integration with Windows almost seamless. +Docker for Windows can now rely on WSL instead of Hyper-V, for example. -! Bear in mind, this setup itself is *not* a container of any kind. If something breaks, there is no rollback capability. You may need to delete the Debian distro altogether and restore it whole. +! Bear in mind, this setup itself is *not* a container of any kind. If something breaks, there is no rollback capability. +! You may need to delete the Debian distro altogether and restore it whole. -## Install Debian 10 +## Install Debian 11 Let's install YunoHost into its own distro, not altering the default one. In a PowerShell terminal: @@ -240,7 +242,7 @@ It is under Debian 9 Stretch, so let's upgrade it: ```bash # In WSL -sudo sed -i 's/stretch/buster/g' /etc/apt/sources.list` +sudo sed -i 's/stretch/bullseye/g' /etc/apt/sources.list` sudo apt update sudo apt upgrade sudo apt dist-upgrade @@ -257,7 +259,8 @@ generateResolvConf = false ## Force the use of iptables-legacy -Somehow the YunoHost post-installation does not like `nf_tables`, the new software replacing `iptables`. We can still explicitely use the good ol' `iptables` though: +Somehow the YunoHost post-installation does not like `nf_tables`, the new software replacing `iptables`. +We can still explicitely use the good ol' `iptables` though: ```bash # In WSL @@ -267,12 +270,13 @@ sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy ## Install Systemd -Debian on WSL does not have `systemd`, a service configuration software. This is a key element for YunoHost, and any decent Debian distro (seriously MS, what the heck). Let's install it: +Debian on WSL does not have `systemd`, a service configuration software. +This is a key element for YunoHost, and for any decent Debian distro (seriously MS, what the heck). Let's install it: 1. Install dotNET runtime: ```bash # In WSL -wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb +wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb sudo apt update sudo apt install -y apt-transport-https @@ -289,7 +293,7 @@ echo "deb [trusted=yes] https://wsl-translinux.arkane-systems.net/apt/ /" > /etc sudo apt update sudo apt install -y systemd-genie ``` - + ## Install YunoHost ```bash @@ -311,7 +315,7 @@ Always call `genie -s` while starting your distro. ## Backup and restore the distro ### Make your first distro backup -As said before, there is no rollback capability. So let's export your fresh distro. :slight_smile: In PowerShell: +As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell: ``` cd ~