1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00

fix [figure] mess 2

This commit is contained in:
OniriCorpe 2024-03-02 02:29:29 +01:00
parent a73bb26cca
commit d9f5bd28ca
4 changed files with 161 additions and 213 deletions

View file

@ -132,21 +132,22 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
[/div]
{% if hardware != '' %}
{% if wsl %}
!! Dieses Setup ist vorwiegend für lokales Testing durch fortgeschrittene Benutzer gedacht. Aufgrund Limitierungen auf WSL Seite (insbesondere veränderliche IP Adresse), selfhosting kann damit knifflig sein und wird hier nicht weiter beschrieben.
{% endif %}
## [fa=list-alt /] Pre-requisites
{% if regular %}
* Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum)
{% elseif rpi34 %}
* Ein Raspberry Pi 3 oder 4
{% elseif rpi012 %}
* Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM
* Ein Raspberry Pi 0, 1 oder 2 mit mindestens 512MB RAM
{% elseif internetcube %}
* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
* Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei
@ -189,9 +190,7 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
{% endif %}
{% if wsl %}
## Vorstellung
WSL ist ein cooles Windows 10 Feature, das Linux pseudo-Distributionen durch die Kommandozeile verfügbar macht. Lass es uns pseudo nennen, weil auch obwohl sie nicht wirklich wie virtuelle Maschinen sind, sind sie auf Virtualisierungskapazitäten angewiesen, die deren Integration mit Windows fast nahtlos machen.
So kann z.B. Docker für Windows jetzt auf WSL bauen, anstatt auf Hyper-V.
@ -217,7 +216,7 @@ rmdir .\debian -R
Nun kannst du darauf zugreifen: Führe `wsl.exe -d YunoHost` aus.
Da es Debian 9 Stretch ist, lass uns ein Upgrade auf Debian 11 Bullseye machen:
Da es Debian 9 Stretch ist, lass uns ein Upgrade auf Debian 11 Bullseye machen:
```bash
# In WSL
@ -226,7 +225,6 @@ sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
```
## Verhindern, dass WSL an Konfigurationsdateien herumfeilt
Bearbeite `/etc/wsl.conf` und füge den folgenden Code darin ein:
@ -254,7 +252,6 @@ Unter WSL fehlt Debian `systemd`, eine Service-Konfigurations-Software.
Diese ist ein Schlüsselelement für YunoHost, und für jede anständige Debian Distro (also ernsthaft Microsoft, was zum Henker). Lass es uns installieren:
1. Installation der dotNET Runtime:
```bash
# In WSL
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@ -266,7 +263,6 @@ sudo apt install -y dotnet-sdk-3.1
```
2. Installation von [Genie](https://github.com/arkane-systems/genie):
```bash
# In WSL
# Das repository hinzufügen
@ -295,10 +291,8 @@ Rufe `genie -s` immer während des Startes deiner Distro auf.
`wsl -d YunoHost -e genie -s`
## Backup und Wiederherstellung der Distro
## Backup und Wiederherstellung der Distro
### Mache dein erstes Distro Backup
Wie zuvor gesagt, gibt es keine Rollback Möglichkeit. Lass uns deshal deine frische Distro exportieren. In PowerShell:
```
@ -313,11 +307,10 @@ cd ~
wsl --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
```
{% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## YunoHost VPS Provider
Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen :
@ -325,19 +318,19 @@ Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen :
[div class="flex-container"]
[div class="flex-child"]
[[figure caption="Alsace Réseau Neutre - FR"]![][image://vps_ynh_arn.png?height=50](/figure)](https://vps.arn-fai.net)
[[figure caption="Alsace Réseau Neutre - FR"]![](image://vps_ynh_arn.png?height=50)[/figure]](https://vps.arn-fai.net)
[/div]
[div class="flex-child"]
[[figure caption="FAImaison - FR"]![][image://vps_ynh_faimaison.svg?height=50](/figure)](https://www.faimaison.net/services/vm.html)
[[figure caption="FAImaison - FR"]![](image://vps_ynh_faimaison.svg?height=50)[/figure]](https://www.faimaison.net/services/vm.html)
[/div]
[div class="flex-child"]
[[figure caption="Association ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](https://www.ecowan.fr/vps-linux)
[[figure caption="Association ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[/div]
[/div]
{% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Lade das {{image_type}} Image herunter
{% if rpi012 %}
@ -403,7 +396,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image)
.replace('{version}', infos.version);
if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -420,16 +413,17 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD Karte mit Adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash das {{image_type}} Image
{% else %}
## ![USB Stick](image://usb_key.png?resize=100,100&class=inline) Flash das YunoHost Image
{% endif %}
Jetzt wo du das Image von {{image_type}} heruntergeladen hast, solltest du es auf {% if arm %}einer microSD Karte{% else %}einem USB stick oder einer CD/DVD flashen.{% endif %}
@ -463,7 +457,6 @@ Führe dann Folgendes aus :
# Ersetze /dev/mmcblk0 durch das richtige Device, wenn der Name deines Device anders ist...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
[/ui-tab]
{% if regular %}
[ui-tab title="Eine CD/DVD brennen"]
@ -500,12 +493,19 @@ Gehe zu **Settings** > **Network**:
{% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Das Board einschalten
* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
* Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen.
* Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. [hier](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md) nachlesen.
* Stecke die SD Karte in dein Board.
* (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst.
* Schalte das Board ein.
@ -513,7 +513,6 @@ Gehe zu **Settings** > **Network**:
* Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server.
{% elseif virtualbox %}
## [fa=plug /] Die virtuelle Maschine hochfahren
Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
@ -522,18 +521,17 @@ Starte die virtuelle Maschine nach der Auswahl des YunoHost Image.
! Wenn du an den Fehler "VT-x ist nicht erreichbar" gerätst, musst du wahrscheinlich Virtualisierung im BIOS deines Computers einschalten.
{% else %}
{% else %}
## [fa=plug /] Die Maschine von deinem USB Stick booten
* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
* Fahre deinen Server mit dem USB Stick oder einer eingesteckten CD-ROM hoch und wähle es durch Drücken einer der folgenden (Hardware spezifischen) Tasten als **bootable device** aus:
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` oder `<DEL>`.
* Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden.
* Anmerkung: Wenn auf dem Server zuvor eine aktuelle Windows Version (8+) installiert war, musst du Windows zuerst "actually reboot" sagen. Das kann irgendwo in "Advanced startup options" gemacht werden.
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Die grafische Installation starten
Du solltest einen Bildschirm wie diesen sehen:
@ -556,10 +554,9 @@ Du solltest einen Bildschirm wie diesen sehen:
Das YunoHost-Projekt hat die klassische Installation so weit wie möglich vereinfacht, damit sich möglichst viele Menschen nicht in zu technischen oder fallbezogenen Fragen verlieren.
Mit der Installation im Expertenmodus hast du mehr Möglichkeiten, insbesondere was die genaue Partitionierung deiner Speichermedien betrifft. Du kannst dich auch für den klassischen Modus entscheiden und [deine Festplatten anschließend hinzufügen](/external_storage).
### Zusammenfassung der Schritte im Expertenmodus
Mit der Installation im Expertenmodus hast du mehr Möglichkeiten, insbesondere was die genaue Partitionierung deiner Speichermedien betrifft. Du kannst dich auch für den klassischen Modus entscheiden und [deine Festplatten anschließend hinzufügen](/external_storage).
### Zusammenfassung der Schritte im Expertenmodus:
1. Wähle `Expert graphical install` aus.
2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und möglicherweise deine Zeitzone aus.
3. Partitioniere deine Festplatten. Hier kanst du ein RAID einrichten oder den Server ganz oder teilweise verschlüsseln.
@ -585,39 +582,32 @@ Wenn du über eine oder mehrere Festplatten zum Speichern von Daten verfügst, k
Wenn du Flexibilität haben möchtest und die Größe von Partitionen nicht (verändern) möchtest, kannst du dich auch dafür entscheiden, auf `/mnt/hdd` zu mounten und dieser [Anleitung zum Mounten aller dieser Ordner mit `mount --bind`](/external_storage) zu folgen.
### Über Verschlüsselung
Beachte: Wenn du deine Festplatten ganz oder teilweise verschlüsselst, musst du bei jedem Neustart deines Servers die Passphrase eingeben. Das kann ein Problem darstellen, wenn du nicht vor Ort bist. Es gibt jedoch (ziemlich schwierig zu implementierende) Lösungen, die es dir ermöglichen, die Passphrase über SSH oder über eine Webseite einzugeben (suche nach "Dropbear Encrypted Disk").
### Über RAID
Denk daran, dass:
* die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt).
* ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist.
* und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen.
* die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt).
* ein RAID 1 (auch ohne Ersatz) aus Wahrscheinlichkeitssicht zuverlässiger als ein RAID 5 ist.
* und Hardware-Raids von der Raid-Karte abhängen. Wenn die Karte ausfällt, benötigst du einen Ersatz, um das Array zu lesen und neu aufzubauen.
[/ui-tab]
[/ui-tabs]
{% endif %}
{% if rpi012 %}
## [fa=bug /] Mit dem Board verbinden und das Image per Hotfix reparieren
Raspberry Pi 1 und 0 werden aufgrund von [Kompilierungsproblemen für diese Architektur](https://github.com/YunoHost/issues/issues/1423) nicht vollständig unterstützt.
Es ist jedoch möglich, das Image selbst zu reparieren, bevor du die Erstkonfiguration ausführst.
Um das zu erreichen, musst du dich auf deinem Raspberry Pi als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort „yunohost“ verbinden:
```
ssh root@yunohost.local
```
(oder „yunohost-2.local“ usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden)
Führe dann die folgenden Befehle aus, um das Metronomproblem zu umgehen:
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -626,7 +616,6 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
Und diesen hier, um das UpnPC-Problem zu umgehen:
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -634,7 +623,6 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! Der letzte Befehl muss nach jedem Yunohost-Upgrade ausgeführt werden :/
{% elseif arm_unsup %}
## [fa=terminal /] Verbindung zum Board
Als nächstes musst du [die lokale IP-Adresse deines Servers finden](/finding_the_local_ip), um dich als Root-Benutzer [über SSH](/ssh) mit dem temporären Passwort `1234` zu verbinden.
@ -647,13 +635,13 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Das Installationsskript ausführen
* Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh))
* Stelle sicher, dass du Root bist (oder gib „sudo -i“ ein, um Root zu werden)
* Führe den folgenden Befehl aus:
- Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh))
- Stelle sicher, dass du Root bist (oder gib „sudo -i“ ein, um Root zu werden)
- Führe den folgenden Befehl aus:
```bash
curl https://install.yunohost.org | bash
@ -741,6 +729,7 @@ Wenn du Subdomains erstellen möchtest, denk daran, diese auch in der Datei `hos
Dieser Benutzer ersetzt den alten `admin` Benutzer, auf den sich einige alte Dokumentationsseiten möglicherweise noch beziehen. In diesem Fall: Ersetzen Sie einfach `admin` durch Ihren Benutzernamen.
## [fa=stethoscope /] Die Erstdiagnose durchführen
Sobald die Post-Installation abgeschlossen ist, solltest du dich tatsächlich mit den Credentials des ersten Benutzers, den du gerade erstellt hast, bei der Webadministrationsoberfläche anmelden können.
@ -758,6 +747,7 @@ Das Diagnosesystem soll eine einfache Möglichkeit bieten, zu überprüfen, ob a
!!! Ist eine Warnung für dich nicht relevant (z.B. weil du nicht vor hast, eine bestimmte Funktion zu verwenden), ist es völlig in Ordnung, das Problem als 'ignoriert' zu markieren, indem du im Webadmin > Diagnose auf den "Ignorieren" Button (für diese bestimmte Funktion) klickst.
[ui-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Empfohlen) Über die Weboberfläche"]
Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". Klicke auf "Erstdiagnose ausführen". Du solltest nun einen Bildschirm wie diesen erhalten:
@ -768,12 +758,10 @@ Um eine Diagnose auszuführen, gehe im Web Admin auf den Abschnitt "Diagnose". K
[/ui-tab]
[ui-tab title="In der Kommandozeile"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -794,15 +782,13 @@ Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat
[/ui-tab]
[ui-tab title="In der Kommandozeile"]
```
```bash
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Gratulation
## ![](image://tada.png?resize=32&classes=inline) Gratulation!
Jetzt hast du ein sehr gut konfigurierten Server. Wenn du neu bei YunoHost bist, empfehlen wir dir, einen Blick auf [die geführte Tour](/overview) zu werfen. Du solltest auch in der Lage sein, [deine Lieblingsanwendungen zu installieren](/apps). Vergiss nicht, [Backups zu planen](/backup)!

View file

@ -126,12 +126,12 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
[/div]
{% if hardware != '' %}
## [fa=list-alt /] Pré-requis
{% if regular %}
* Un matériel compatible x86 dédié à YunoHost : portable, netbook, ordinateur avec 512Mo de RAM et 16Go de capacité de stockage (au moins) ;
{% elseif rpi34 %}
* Un Raspberry Pi 3 ou 4 ;
@ -172,8 +172,10 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
! N.B. : Installer YunoHost dans une VirtualBox est généralement destiné à tester la distribution ou pour développer. VirtualBox n'est pas pratique pour faire tourner un 'vrai' serveur sur le long terme car la machine surlaquelle il est installé ne sera sans doute pas allumé 24h/24, et parce que Virtualbox rajoute une couche de complexité supplémentaire pour ce qui est d'exposer la machine sur Internet.
{% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## Fournisseurs de VPS YunoHost
Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
@ -181,19 +183,19 @@ Ci-dessous une liste de fournisseurs de VPS supportant nativement YunoHost :
[div class="flex-container"]
[div class="flex-child"]
[[figure caption="Alsace Réseau Neutre - FR"]![][image://vps_ynh_arn.png?height=50](/figure)](<https://vps.arn-fai.net>)
[[figure caption="Alsace Réseau Neutre - FR"]![](image://vps_ynh_arn.png?height=50)[/figure]](https://vps.arn-fai.net)
[/div]
[div class="flex-child"]
[[figure caption="FAImaison - FR"]![][image://vps_ynh_faimaison.svg?height=50](/figure)](<https://www.faimaison.net/services/vm.html>)
[[figure caption="FAImaison - FR"]![](image://vps_ynh_faimaison.svg?height=50)[/figure]](https://www.faimaison.net/services/vm.html)
[/div]
[div class="flex-child"]
[[figure caption="ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](<https://www.ecowan.fr/vps-linux>)
[[figure caption="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[/div]
[/div]
{% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Télécharger l'image {{image_type}}
{% if rpi012 %}
@ -259,7 +261,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image)
.replace('{version}', infos.version);
if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -276,16 +278,17 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flasher l'image {{image_type}}
{% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flasher l'image YunoHost
{% endif %}
Maintenant que vous avez téléchargé limage de {{image_type}}, vous devez la mettre sur {% if arm %}une carte microSD{% else %}une clé USB ou un CD/DVD.{% endif %}
@ -336,11 +339,10 @@ Pour les anciens matériels, il vous faut peut-être utiliser un CD/DVD. Le logi
Ventoy sera utile si vous n'arrivez pas à démarrer l'image de Yunohost en utilisant les autres méthodes
[Ventoy](https://www.ventoy.net/) est un outil pratique qui permet de mettre plusieurs images Linux sur une même clé USB et démarrer ces images sans devoir re-flasher la clé USB à chaque fois. C'est aussi pratique pour démarer une image qui refuse de démarrer: Ventoy réussi habituellement à tout démarrer!
1. Installer [Ventoy](https://www.ventoy.net/) sur la clé USB. Référez-vous aux [instructions d'installation](https://www.ventoy.net/en/doc_start.html).
* Cela va créer 2 partition sur la clé USB.
- Cela va créer 2 partition sur la clé USB.
3. En utilisant votre application de fichiers préférée, copiez l'image Yunohost sur la grande partition "Ventoy (pas celle "VTOYEFI")
* N'utilisez pas *Balena Etcher*, USBImager ou `dd` pour faire ça!
- N'utilisez pas *Balena Etcher*, USBImager ou `dd` pour faire ça!
Insérez cette clé USB dans l'ordinateur et démarrez en utisant celle-ci. Ventoy va apparaitre et lister toutes les images qui sont sur la clé USB. Sélectionnez l'image de Yunohost. Sélectionnez ensuite "GRUB2" comme option de démarrage (ou utilisez n'importe laquelle qui fonctionnera sur votre ordinateur 😉)
[/ui-tab]
@ -369,8 +371,15 @@ Allez dans **Réglages** > **Réseau** :
{% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Démarrer la carte
* Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre carte).
@ -382,7 +391,6 @@ Allez dans **Réglages** > **Réseau** :
* Assurez-vous que votre ordinateur (de bureau ou portable) est connecté au même réseau local (c'est-à-dire la même box Internet) que votre serveur.
{% elseif virtualbox %}
## [fa=plug /] Lancer la machine virtuelle
Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
@ -392,21 +400,20 @@ Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost.
! Si vous rencontrez l'erreur "VT-x is not available", il vous faut probablement activer (enable) la virtualisation dans les options du BIOS de votre ordinateur.
{% else %}
## [fa=plug /] Démarrer la machine sur la clé USB
* Branchez le câble Ethernet (un côté à votre box, de l'autre côté à votre carte).
* Démarrez votre serveur avec la clé USB ou le CD-ROM inséré, et sélectionnez-le comme **périphérique de démarrage (bootable device)** en pressant lune des touches suivantes (dépendant de votre ordinateur) :
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` ou <Alt>.
* N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une option du menu « Options de démarrage avancées ».
* N.B. : si le serveur était précédemment installé avec une version récente de Windows (8+), vous devez d'abord demander à Windows de « redémarrer réellement ». Vous pouvez le faire dans une option du menu « Options de démarrage avancées ».
!!! Si vous n'arrivez pas à démarrer l'image Yunohost, essayez d'utiliser Ventoy (sélectionnez "Ventoy" dans la section "Flasher l'image YunoHost" ci-dessus).
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Lancer linstallation graphique
Votre écran devrait ressembler à la capture ci-dessous :
[figure class="nomargin" caption="Capture d'écran du menu de l'ISO"]
@ -425,10 +432,9 @@ Votre écran devrait ressembler à la capture ci-dessous :
Le projet YunoHost a simplifié au maximum l'installation classique afin d'éviter au plus grand nombre d'être perdu avec des questions trop techniques ou liées à des cas particuliers.
Avec l'installation en mode expert, vous avez plus de possibilités notamment concernant le partitionnement exact de vos supports de stockages. Vous pouvez aussi décider d'utiliser le mode classique et [ajouter vos disques après coup](/external_storage).
### Résumé des étapes en mode expert
Avec l'installation en mode expert, vous avez plus de possibilités notamment concernant le partitionnement exact de vos supports de stockages. Vous pouvez aussi décider d'utiliser le mode classique et [ajouter vos disques après coup](/external_storage).
### Résumé des étapes en mode expert:
1. Sélectionnez `Expert graphical install`
2. Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone.
3. Partitionner vos disques. C'est à cette étape que vous pouvez configurer un RAID ou chiffrer tout ou partie du serveur.
@ -454,16 +460,13 @@ Si vous avez un ou des disques durs pour stocker les données, vous pouvez chois
Si vous souhaitez de la souplesse et ne pas avoir à (re-)dimensionner des partitions, vous pouvez aussi choisir de monter sur `/mnt/hdd` et de suivre ce [tutoriel pour monter l'ensemble de ces dossiers avec `mount --bind`](/external_storage).
### A propos du chiffrement
Prenez bien en compte que si vous chiffrez tout ou partie de vos disques, vous aurez à taper la phrase de passe à chaque redémarrage de votre serveur, ce qui peut poser problème si vous n'êtes pas sur place. Il existe toutefois des solutions (assez difficiles à mettre en oeuvre) qui permettent de tapper la phrase via SSH ou via une page web (cherchez "dropbear encrypted disk").
### A propos du RAID
Ne perdez pas de vue que:
* les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
* un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité
* les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe
* les disques de vos RAID doivent être de marque, d'usure ou de lots distincts (surtout si ce sont des SSD)
* un RAID 1 (même sans disque de spare) est plus fiable qu'un RAID5 d'un point de vue probabilité
* les raid matériels sont dépendant de la carte raid, si celle-ci fait défaut il en faudra une de remplacement pour pouvoir lire et reconstruire la grappe
[/ui-tab]
[/ui-tabs]
@ -471,24 +474,20 @@ Ne perdez pas de vue que:
!!! Si l'installation de Yunohost échoue sur votre machine et que vous n'arrivez pas à résoudre le problème, sachez qu'il est aussi possible d'installer Debian et ensuite d'installer Yunohost dessus. Pour les instructions, au sommet de cette page, sélectionnez "Serveur distant" puis "VPS ou serveur dédié avec Debian".
{% endif %}
{% if rpi012 %}
## [fa=bug /] Se connecter à la carte et corriger l'image
Les Raspberry Pi 1 et Zero ne sont pas totalement supportés à cause de [problèmes de compilation pour cette architecture](https://github.com/YunoHost/issues/issues/1423).
Cependant, il est possible de corriger l'image par vous-même avant de lancer la configuration initiale.
Pour y parvenir, vous devez vous connecter à votre Raspberry Pi en tant que root [via SSH](/ssh) avec le mot de passe temporaire `yunohost`:
```
ssh root@yunohost.local
```
(utilisez `yunohost-2.local`, etc. s'il y a plusieurs serveurs YunoHost sur le réseau)
Ensuite, lancez les commandes suivantes pour contourner le dysfonctionnement de Metronome :
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -497,7 +496,6 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
Et celle-ci pour contourner celui de upnpc :
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -505,7 +503,6 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! Cette dernière commande nécessite d'être lancée après chaque mise à jour de YunoHost :/
{% elseif arm_unsup %}
## [fa=terminal /] Se connecter à la carte
Ensuite, il vous faut [trouver l'adresse IP locale de votre serveur](/finding_the_local_ip) pour vous connecter en tant que root [via SSH](/ssh) avec le mot de passe temporaire `1234`.
@ -518,18 +515,17 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Lancer le script d'installation
* Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh))
* Assurez-vous d'être connecté en tant que root (ou tapez `sudo -i` pour le devenir)
* Lancez la commande suivante :
- Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh))
- Assurez-vous d'être connecté en tant que root (ou tapez `sudo -i` pour le devenir)
- Lancez la commande suivante :
```bash
curl https://install.yunohost.org | bash
```
!!! Si `curl` n'est pas installé sur votre système, il vous faudra peut-être l'installer avec `apt install curl`.
!!! Autrement, si la commande n'affiche rien du tout, vous pouvez tenter `apt install ca-certificates`
@ -537,6 +533,7 @@ curl https://install.yunohost.org | bash
{% endif %}
## [fa=cog /] Lancer la configuration initiale
!!! Si vous êtes en train de restaurer une sauvegarde YunoHost, vous devez sauter cette étape et vous référer à la section [Restaurer durant la post-installation à la place de cette étape de configuration initiale](/backup#restoring-during-the-postinstall).
@ -588,7 +585,7 @@ Cest le nom de domaine qui permettra laccès à votre serveur ainsi qua
##### [fa=key /] Premier compte utilisateur
[Depuis YunoHost 11.1](https://forum.yunohost.org/t/yunohost-11-1-release-sortie-de-yunohost-11-1/23378), le premier compte utilisateur est créé à cette étape. Il vous faudra choisir un nom d'utilisateur et un mot de passe raisonablement complexe. (Nous ne pouvons que souligner l'importance du choix d'un mot de passe **robuste** !) Ce compte utilisateur sera ajouté au groupe Admins, et pourra se connecter au portail utilisateur, à la webadmin, et se connecter [via **SSH**](/ssh) ou [**SFTP**](/filezilla). Les admins recevront aussi les mails envoyés à `root@votredomaine.tld` et `admin@votredomaine.tld` : ces emails peuvent être utilisés pour envoyer des informations ou des alertes techniques. Vous pourrez plus tard ajouter d'autres comptes utilisateur supplémentaire, qu'il est aussi possible d'ajouter au groupe Admins.
Ce compte remplace l'ancien compte `admin`, qui est peut être toujours mentionné dans certaines pages de documentation. Dans ce cas, remplacez simplement `admin` par votre identifiant.
## [fa=stethoscope /] Lancer le diagnostic
@ -615,12 +612,10 @@ Pour lancer le diagnostic, allez dans l'Administration Web dans la partie Diagno
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -639,15 +634,13 @@ Pour plus d'instructions détaillées, ou pour en savoir plus à propos des cert
[/ui-tab]
[ui-tab title="À partir de la ligne de commande"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Félicitations
## ![](image://tada.png?resize=32&classes=inline) Félicitations !
Vous avez maintenant un serveur plutôt bien configuré. Si vous découvrez YunoHost, nous vous recommandons de jeter un œil à [la visite guidée](/overview). Vous devriez aussi être en mesure d'[installer vos applications favorites](/apps). N'oubliez pas de [prévoir des sauvegardes](/backup) !

View file

@ -132,21 +132,22 @@ Select the hardware on which you want install YunoHost :
[/div]
{% if hardware != '' %}
{% if wsl %}
!! This setup is mainly meant for local testing by advanced users. Due to limitations on WSL's side (changing IP address, notably), selfhosting from it can be tricky and will not be described here.
{% endif %}
## [fa=list-alt /] Pre-requisites
{% if regular %}
* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least)
{% elseif rpi34 %}
* A Raspberry Pi 3 or 4
{% elseif rpi012 %}
* A Raspberry Pi 0, 1 or 2 with at least 512MB RAM
* A Raspberry Pi 0, 1 or 2 with at least 512MB RAM
{% elseif internetcube %}
* An Orange Pi PC+ or an Olinuxino Lime 1 or 2
* A VPN with a dedicated public IP and a `.cube` file
@ -189,9 +190,7 @@ Select the hardware on which you want install YunoHost :
{% endif %}
{% 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.
@ -217,7 +216,7 @@ rmdir .\debian -R
You can now access it: run `wsl.exe -d YunoHost`
It is under Debian 9 Stretch, so let's upgrade it:
It is under Debian 9 Stretch, so let's upgrade it:
```bash
# In WSL
@ -226,7 +225,6 @@ sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
```
## Prevent WSL from tweaking configuration files
Edit `/etc/wsl.conf` and put the following code in it:
@ -254,7 +252,6 @@ 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/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@ -266,7 +263,6 @@ sudo apt install -y dotnet-sdk-3.1
```
2. Install [Genie](https://github.com/arkane-systems/genie):
```bash
# In WSL
# Add their repository
@ -295,10 +291,8 @@ Always call `genie -s` while starting your distro.
`wsl -d YunoHost -e genie -s`
## Backup and restore the 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. In PowerShell:
```
@ -313,11 +307,10 @@ cd ~
wsl --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
```
{% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## YunoHost VPS providers
Here are some VPS providers supporting YunoHost natively :
@ -325,19 +318,19 @@ Here are some VPS providers supporting YunoHost natively :
[div class="flex-container"]
[div class="flex-child"]
[[figure caption="Alsace Réseau Neutre - FR"]![][image://vps_ynh_arn.png?height=50](/figure)](<https://vps.arn-fai.net>)
[[figure caption="Alsace Réseau Neutre - FR"]![](image://vps_ynh_arn.png?height=50)[/figure]](https://vps.arn-fai.net)
[/div]
[div class="flex-child"]
[[figure caption="FAImaison - FR"]![][image://vps_ynh_faimaison.svg?height=50](/figure)](<https://www.faimaison.net/services/vm.html>)
[[figure caption="FAImaison - FR"]![](image://vps_ynh_faimaison.svg?height=50)[/figure]](https://www.faimaison.net/services/vm.html)
[/div]
[div class="flex-child"]
[[figure caption="ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](<https://www.ecowan.fr/vps-linux>)
[[figure caption="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[/div]
[/div]
{% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Download the {{image_type}} image
{% if rpi012 %}
@ -403,7 +396,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image)
.replace('{version}', infos.version);
if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -420,16 +413,17 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
{% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
{% endif %}
Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %}
@ -463,7 +457,6 @@ Then run :
# Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
[/ui-tab]
{% if regular %}
[ui-tab title="Burning a CD/DVD"]
@ -479,11 +472,10 @@ For older devices, you might want to burn a CD/DVD. The software to use depends
Ventoy will be useful if you can't sucessfully boot the Yunohost image using the other methods.
[Ventoy](https://www.ventoy.net/) is a nice tool that makes it really easy to put multiple linux images on a USB stick. When the computer refuses to boot from an image on a usb stick, Ventoy will usually be able to boot it anyway!
1. Install [Ventoy](https://www.ventoy.net/) on the USB stick. Refer to the [install instructions](https://www.ventoy.net/en/doc_start.html).
* This will create 2 partitions on the stick.
- This will create 2 partitions on the stick.
3. Using your favorite file explorer app, copy the Yunohost image file on the big `Ventoy` partition (not "VTOYEFI")
* Don't use *Balena Etcher*, USBImager or `dd` for this!
- Don't use *Balena Etcher*, USBImager or `dd` for this!
Later, when you'll boot the computer using this usb stick, Ventoy will appear and will list the images on the USB stick. Select the Yunohost image, then select GRUB2 launch option (or use whichever works for your computer 😉)
[/ui-tab]
@ -512,12 +504,19 @@ Go to **Settings** > **Network**:
{% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your board).
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([or here prior to YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.com/documentation/computers/configuration.html#connect-to-a-wireless-network) ([or here prior to YunoHost12/bookworm](https://www.raspberryme.com/configurer-le-wifi-sur-un-pi-manuellement-a-laide-de-wpa_supplicant-conf/).
* Plug the SD card in your board
* (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
* Power up the board
@ -525,7 +524,6 @@ Go to **Settings** > **Network**:
* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
{% elseif virtualbox %}
## [fa=plug /] Boot up the virtual machine
Start the virtual machine after selecting the YunoHost image.
@ -534,20 +532,19 @@ Start the virtual machine after selecting the YunoHost image.
! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
{% else %}
{% else %}
## [fa=plug /] Boot the machine on your USB stick
* Plug the ethernet cable (one side on your main router, the other on your server).
* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device**. Depending on your hardware, you will need to press one of the following keys:
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` or `<Alt>`.
* N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
* N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
!!! If you can't boot the Yunohost image, try using Ventoy (select "Ventoy" in the section "Flash the YunoHost image" above).
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Launch the graphical install
You should see a screen like this:
@ -570,10 +567,9 @@ You should see a screen like this:
The YunoHost project simplified the classic installation as much as possible in order to avoid as many people as possible being lost with questions that are too technical or related to specific cases.
With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
### Summary of the steps in expert mode
With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
### Summary of the steps in expert mode:
1. Select `Expert graphical install`.
2. Select your language, location, keyboard layout and possibly your timezone.
3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server.
@ -599,16 +595,13 @@ If you have one or more hard drives to store data, you can choose to mount it on
If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage).
### About encryption
Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk").
### About RAID
Keep in mind that:
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
[/ui-tab]
[/ui-tabs]
@ -616,24 +609,20 @@ Keep in mind that:
!!! If the Yunohost installer fails and you can't solve the issue, know that it's also possible to install Debian and then install Yunohost on top. For instructions, at the top of this page, select "Remote server", then "VPS or dedicated server with Debian".
{% endif %}
{% if rpi012 %}
## [fa=bug /] Connect to the board and hotfix the image
Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423).
However, it is possible to fix by yourself the image before to run the initial configuration.
To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`:
```
ssh root@yunohost.local
```
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
Then run the following commands to work around the metronome issue:
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -642,7 +631,6 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
And this one to work around the upnpc issue:
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -650,7 +638,6 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! This last command need to be run after each yunohost upgrade :/
{% elseif arm_unsup %}
## [fa=terminal /] Connect to the board
Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`.
@ -663,13 +650,13 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Run the install script
* Open a command line prompt on your server (either directly or [through SSH](/ssh))
* Make sure you are root (or type `sudo -i` to become root)
* Run the following command:
- Open a command line prompt on your server (either directly or [through SSH](/ssh))
- Make sure you are root (or type `sudo -i` to become root)
- Run the following command:
```bash
curl https://install.yunohost.org | bash
@ -757,6 +744,7 @@ If you want to create subdomains, do not forget to add them in the `hosts` file
This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username.
## [fa=stethoscope /] Run the initial diagnosis
Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created.
@ -784,12 +772,10 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -810,15 +796,13 @@ Go in Domains > Click on your domain > SSL Certificate
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Congratz
## ![](image://tada.png?resize=32&classes=inline) Congratz!
You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at [the guided tour](/overview). You should also be able to [install your favourite applications](/apps). Don't forget to [plan backups](/backup) !

View file

@ -132,21 +132,22 @@ routes:
[/div]
{% if hardware != '' %}
{% if wsl %}
!! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет.
{% endif %}
## [fa=list-alt /] Предварительные условия
{% if regular %}
* x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
{% elseif rpi34 %}
* Raspberry Pi 3 or 4
{% elseif rpi012 %}
* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ
* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ
{% elseif internetcube %}
* Orange Pi PC+ или Olinuxino Lime 1 или 2
* VPN с выделенным общедоступным IP-адресом и файлом `.cube`
@ -189,9 +190,7 @@ routes:
{% endif %}
{% if wsl %}
## Вступление
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.
@ -217,7 +216,7 @@ rmdir .\debian -R
You can now access it: run `wsl.exe -d YunoHost`
It is under Debian 9 Stretch, so let's upgrade it:
It is under Debian 9 Stretch, so let's upgrade it:
```bash
# In WSL
@ -226,7 +225,6 @@ sudo apt update
sudo apt upgrade
sudo apt dist-upgrade
```
## Prevent WSL from tweaking configuration files
Edit `/etc/wsl.conf` and put the following code in it:
@ -254,7 +252,6 @@ 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/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
@ -266,7 +263,6 @@ sudo apt install -y dotnet-sdk-3.1
```
2. Install [Genie](https://github.com/arkane-systems/genie):
```bash
# In WSL
# Add their repository
@ -295,10 +291,8 @@ Always call `genie -s` while starting your distro.
`wsl -d YunoHost -e genie -s`
## Backup and restore the 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. In PowerShell:
```
@ -313,11 +307,10 @@ cd ~
wsl --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
```
{% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## YunoHost VPS providers
Here are some VPS providers supporting YunoHost natively :
@ -325,19 +318,19 @@ Here are some VPS providers supporting YunoHost natively :
[div class="flex-container"]
[div class="flex-child"]
[[figure caption="Alsace Réseau Neutre - FR"]![][image://vps_ynh_arn.png?height=50](/figure)](<https://vps.arn-fai.net>)
[[figure caption="Alsace Réseau Neutre - FR"]![](image://vps_ynh_arn.png?height=50)[/figure]](https://vps.arn-fai.net)
[/div]
[div class="flex-child"]
[[figure caption="FAImaison - FR"]![][image://vps_ynh_faimaison.svg?height=50](/figure)](<https://www.faimaison.net/services/vm.html>)
[[figure caption="FAImaison - FR"]![](image://vps_ynh_faimaison.svg?height=50)[/figure]](https://www.faimaison.net/services/vm.html)
[/div]
[div class="flex-child"]
[[figure caption="ECOWAN - FR"]![][image://vps_ynh_ecowan.png?height=50](/figure)](<https://www.ecowan.fr/vps-linux>)
[[figure caption="ECOWAN - FR"]![](image://vps_ynh_ecowan.png?height=50)[/figure]](https://www.ecowan.fr/vps-linux)
[/div]
[/div]
{% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Download the {{image_type}} image
{% if rpi012 %}
@ -403,7 +396,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image)
.replace('{version}', infos.version);
if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -420,16 +413,17 @@ $(document).ready(function () {
});
</script>
{% if not virtualbox %}
{% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
{% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
{% endif %}
Now that you downloaded the image of {{image_type}}, you should flash it on {% if arm %}a microSD card{% else %}a USB stick or a CD/DVD.{% endif %}
@ -463,7 +457,6 @@ Then run :
# Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0
```
[/ui-tab]
{% if regular %}
[ui-tab title="Burning a CD/DVD"]
@ -500,12 +493,19 @@ Go to **Settings** > **Network**:
{% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your board).
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
* For advanced users willing to configure the board to connect to WiFi instead, see for example [here](https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md).
* Plug the SD card in your board
* (Optional) You can connect a screen+keyboard directly on your board if you want to troubleshoot the boot process or if you're more comfortable to "see what happens" or want a direct access to the board.
* Power up the board
@ -513,7 +513,6 @@ Go to **Settings** > **Network**:
* Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
{% elseif virtualbox %}
## [fa=plug /] Boot up the virtual machine
Start the virtual machine after selecting the YunoHost image.
@ -522,18 +521,17 @@ Start the virtual machine after selecting the YunoHost image.
! If you encounter the error "VT-x is not available", you probably need to enable Virtualization in the BIOS of your computer.
{% else %}
{% else %}
## [fa=plug /] Boot the machine on your USB stick
* Plug the ethernet cable (one side on your main router, the other on your server).
* Boot up your server with the USB stick or a CD-ROM inserted, and select it as **bootable device** by pressing one of the following keys (hardware specific):
`<ESC>`, `<F9>`, `<F10>`, `<F11>`, `<F12>` or `<DEL>`.
* N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
* N.B. : if the server was previously installed with a recent version of Windows (8+), you first need to tell Windows, to "actually reboot". This can be done somewhere in "Advanced startup options".
{% endif %}
{% if regular or virtualbox %}
## [fa=rocket /] Launch the graphical install
You should see a screen like this:
@ -556,10 +554,9 @@ You should see a screen like this:
The YunoHost project simplified the classic installation as much as possible in order to avoid as many people as possible being lost with questions that are too technical or related to specific cases.
With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
### Summary of the steps in expert mode
With the expert mode installation, you have more possibilities, especially concerning the exact partitioning of your storage media. You can also decide to use the classic mode and [add your disks afterwards](/external_storage).
### Summary of the steps in expert mode:
1. Select `Expert graphical install`.
2. Select your language, location, keyboard layout and possibly your timezone.
3. Partition your disks. This is where you can set up a RAID or encrypt all or part of the server.
@ -585,39 +582,32 @@ If you have one or more hard drives to store data, you can choose to mount it on
If you want flexibility and don't want to (re)size partitions, you can also choose to mount on `/mnt/hdd` and follow this [tutorial to mount all these folders with `mount --bind`](/external_storage).
### About encryption
Be aware that if you encrypt all or part of your disks, you will have to type the passphrase every time you restart your server, which can be a problem if you are not on site. There are however solutions (quite difficult to implement) that allow you to type the passphrase via SSH or via a web page (search for "dropbear encrypted disk").
### About RAID
Keep in mind that:
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* a RAID 1 (even without a spare) is more reliable than a RAID 5 from a probability point of view
* hardware raids are dependent on the raid card, if the card fails you will need a replacement to read and rebuild the array
[/ui-tab]
[/ui-tabs]
{% endif %}
{% if rpi012 %}
## [fa=bug /] Connect to the board and hotfix the image
Raspberry Pi 1 and 0 are not totally supported due to [compilation issues for this architecture](https://github.com/YunoHost/issues/issues/1423).
However, it is possible to fix by yourself the image before to run the initial configuration.
To achieve this, you need to connect on your raspberry pi as root user [via SSH](/ssh) with the temporary password `yunohost`:
```
ssh root@yunohost.local
```
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network)
Then run the following commands to work around the metronome issue:
```
mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.bkp}
@ -626,7 +616,6 @@ ln -s /usr/bin/true /usr/bin/metronomectl
```
And this one to work around the upnpc issue:
```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py
```
@ -634,7 +623,6 @@ sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/fir
! This last command need to be run after each yunohost upgrade :/
{% elseif arm_unsup %}
## [fa=terminal /] Connect to the board
Next you need to [find the local IP address of your server](/finding_the_local_ip) to connect as root user [via SSH](/ssh) with the temporary password `1234`.
@ -647,13 +635,13 @@ ssh root@192.168.x.xxx
{% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Run the install script
* Open a command line prompt on your server (either directly or [through SSH](/ssh))
* Make sure you are root (or type `sudo -i` to become root)
* Run the following command:
- Open a command line prompt on your server (either directly or [through SSH](/ssh))
- Make sure you are root (or type `sudo -i` to become root)
- Run the following command:
```bash
curl https://install.yunohost.org | bash
@ -741,6 +729,7 @@ If you want to create subdomains, do not forget to add them in the `hosts` file
This user replaces the old `admin` user, which some old documentation page may still refer to. In which case : just replace `admin` with your username.
## [fa=stethoscope /] Run the initial diagnosis
Once the postinstall is done, you should be able to actually log in the web admin interface using the credentials of the first user you just created.
@ -768,12 +757,10 @@ To run a diagnosis, go on Web Admin in the Diagnosis section. Click Run initial
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost diagnosis run
yunohost diagnosis show --issues --human-readable
```
[/ui-tab]
[/ui-tabs]
@ -794,15 +781,13 @@ Go in Domains > Click on your domain > SSL Certificate
[/ui-tab]
[ui-tab title="From the command line"]
```
yunohost domain cert install
```
[/ui-tab]
[/ui-tabs]
## ![](image://tada.png?resize=32&classes=inline) Congratz
## ![](image://tada.png?resize=32&classes=inline) Congratz!
You now have a pretty well configured server. If you're new to YunoHost, we recommend to have a look at [the guided tour](/overview). You should also be able to [install your favourite applications](/apps). Don't forget to [plan backups](/backup) !