YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

fix [figure] mess 2

Browse source
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
Show stats Download patch file Download diff file Expand all files Collapse all files

96
pages/02.administer/10.install/install.de.md
View file

@ -132,21 +132,22 @@ Wähle die Hardware, auf der du YunoHost installieren willst :
[/div] [/div]
{% if hardware != '' %} {% if hardware != '' %}
{% if wsl %} {% 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. !! 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 %} {% endif %}
## [fa=list-alt /] Pre-requisites ## [fa=list-alt /] Pre-requisites
{% if regular %} {% if regular %}
* Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum) * Eine x86-kompatible für YunoHost bestimmte (dedizierte) Hardware: Laptop, Nettop, Netbook, Desktop mit 512MB RAM und 16GB Speicherkapazität (Minimum)
{% elseif rpi34 %} {% elseif rpi34 %}
* Ein Raspberry Pi 3 oder 4 * Ein Raspberry Pi 3 oder 4
{% elseif rpi012 %} {% 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 %} {% elseif internetcube %}
* Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2 * Ein Orange Pi PC+ oder ein Olinuxino Lime 1 oder 2
* Ein VPN mit einer festen öffentlichen IP Adresse und einer `.cube` Datei * 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 %} {% endif %}
{% if wsl %} {% if wsl %}
## Vorstellung ## 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. 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. 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. 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 ```bash
# In WSL # In WSL
@ -226,7 +225,6 @@ sudo apt update
sudo apt upgrade sudo apt upgrade
sudo apt dist-upgrade sudo apt dist-upgrade
``` ```
## Verhindern, dass WSL an Konfigurationsdateien herumfeilt ## Verhindern, dass WSL an Konfigurationsdateien herumfeilt
Bearbeite `/etc/wsl.conf` und füge den folgenden Code darin ein: 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: 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: 1. Installation der dotNET Runtime:
```bash ```bash
# In WSL # In WSL
wget https://packages.microsoft.com/config/debian/11/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
@ -266,7 +263,6 @@ sudo apt install -y dotnet-sdk-3.1
``` ```
2. Installation von [Genie](https://github.com/arkane-systems/genie): 2. Installation von [Genie](https://github.com/arkane-systems/genie):
```bash ```bash
# In WSL # In WSL
# Das repository hinzufügen # 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` `wsl -d YunoHost -e genie -s`
## Backup und Wiederherstellung der Distro ## Backup und Wiederherstellung der Distro
### Mache dein erstes Distro Backup ### Mache dein erstes Distro Backup
Wie zuvor gesagt, gibt es keine Rollback Möglichkeit. Lass uns deshal deine frische Distro exportieren. In PowerShell: 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 --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
``` ```
{% endif %} {% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## YunoHost VPS Provider ## YunoHost VPS Provider
Hier sind ein paar VPS Provider, die YunoHost nativ unterstützen : 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-container"]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[/div] [/div]
{% endif %} {% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Lade das {{image_type}} Image herunter ## [fa=download /] Lade das {{image_type}} Image herunter
{% if rpi012 %} {% if rpi012 %}
@ -403,7 +396,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image) .replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image) .replace('{image}', infos.image)
.replace('{version}', infos.version); .replace('{version}', infos.version);
if (!infos.file.startsWith("http")) if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file; infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -420,16 +413,17 @@ $(document).ready(function () {
}); });
</script> </script>
{% if not virtualbox %} {% if not virtualbox %}
{% if arm %} {% if arm %}
## ![microSD Karte mit Adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash das {{image_type}} Image ## ![microSD Karte mit Adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash das {{image_type}} Image
{% else %} {% else %}
## ![USB Stick](image://usb_key.png?resize=100,100&class=inline) Flash das YunoHost Image ## ![USB Stick](image://usb_key.png?resize=100,100&class=inline) Flash das YunoHost Image
{% endif %} {% 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 %} 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... # Ersetze /dev/mmcblk0 durch das richtige Device, wenn der Name deines Device anders ist...
dd if=/path/to/yunohost.img of=/dev/mmcblk0 dd if=/path/to/yunohost.img of=/dev/mmcblk0
``` ```
[/ui-tab] [/ui-tab]
{% if regular %} {% if regular %}
[ui-tab title="Eine CD/DVD brennen"] [ui-tab title="Eine CD/DVD brennen"]
@ -500,12 +493,19 @@ Gehe zu **Settings** > **Network**:
{% endif %} {% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Das Board einschalten ## [fa=plug /] Das Board einschalten
* Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board). * 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. * 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. * (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. * 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. * 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 %} {% elseif virtualbox %}
## [fa=plug /] Die virtuelle Maschine hochfahren ## [fa=plug /] Die virtuelle Maschine hochfahren
Starte die virtuelle Maschine nach der Auswahl des YunoHost Image. 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. ! 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 ## [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). * 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: * 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>`. `<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 %} {% endif %}
{% if regular or virtualbox %} {% if regular or virtualbox %}
## [fa=rocket /] Die grafische Installation starten ## [fa=rocket /] Die grafische Installation starten
Du solltest einen Bildschirm wie diesen sehen: 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. 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). 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
### Zusammenfassung der Schritte im Expertenmodus:
1. Wähle `Expert graphical install` aus. 1. Wähle `Expert graphical install` aus.
2. Wähle deine Sprache, deinen Standort, dein Tastaturlayout und möglicherweise deine Zeitzone 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. 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. 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 ### Ü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"). 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 ### Über RAID
Denk daran, dass: Denk daran, dass:
* die Festplatten in deinen RAIDs von unterschiedlichen Marken, Abnutzungserscheinungen oder Chargen sein müssen (insbesondere, wenn es sich um SSDs handelt).
* 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.
* 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.
* 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-tab]
[/ui-tabs] [/ui-tabs]
{% endif %} {% endif %}
{% if rpi012 %} {% if rpi012 %}
## [fa=bug /] Mit dem Board verbinden und das Image per Hotfix reparieren ## [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. 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. 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: 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 ssh root@yunohost.local
``` ```
(oder „yunohost-2.local“ usw., wenn sich mehrere YunoHost-Server in deinem Netzwerk befinden) (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: Führe dann die folgenden Befehle aus, um das Metronomproblem zu umgehen:
``` ```
mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.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: Und diesen hier, um das UpnPC-Problem zu umgehen:
``` ```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py 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 :/ ! Der letzte Befehl muss nach jedem Yunohost-Upgrade ausgeführt werden :/
{% elseif arm_unsup %} {% elseif arm_unsup %}
## [fa=terminal /] Verbindung zum Board ## [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. 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 %} {% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Das Installationsskript ausführen ## [fa=rocket /] Das Installationsskript ausführen
* Öffne eine Kommandozeile auf deinem Server (entweder direkt oder [über SSH](/ssh)) - Ö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) - Stelle sicher, dass du Root bist (oder gib „sudo -i“ ein, um Root zu werden)
* Führe den folgenden Befehl aus: - Führe den folgenden Befehl aus:
```bash ```bash
curl https://install.yunohost.org | 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. 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 ## [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. 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. !!! 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-tabs position="top-left" active="0" theme="lite"]
[ui-tab title="(Empfohlen) Über die Weboberfläche"] [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: 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]
[ui-tab title="In der Kommandozeile"] [ui-tab title="In der Kommandozeile"]
``` ```
yunohost diagnosis run yunohost diagnosis run
yunohost diagnosis show --issues --human-readable yunohost diagnosis show --issues --human-readable
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/ui-tabs]
@ -794,15 +782,13 @@ Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat
[/ui-tab] [/ui-tab]
[ui-tab title="In der Kommandozeile"] [ui-tab title="In der Kommandozeile"]
```bash
```
yunohost domain cert install yunohost domain cert install
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/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)! 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)!

87
pages/02.administer/10.install/install.fr.md
View file

@ -126,12 +126,12 @@ Sélectionnez le matériel sur lequel vous souhaitez installer YunoHost :
[/div] [/div]
{% if hardware != '' %} {% if hardware != '' %}
## [fa=list-alt /] Pré-requis ## [fa=list-alt /] Pré-requis
{% if regular %} {% 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) ; * 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 %} {% elseif rpi34 %}
* Un Raspberry Pi 3 ou 4 ; * 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. ! 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 %} {% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## Fournisseurs de VPS YunoHost ## Fournisseurs de VPS YunoHost
Ci-dessous une liste de fournisseurs de VPS supportant nativement 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-container"]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[/div] [/div]
{% endif %} {% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Télécharger l'image {{image_type}} ## [fa=download /] Télécharger l'image {{image_type}}
{% if rpi012 %} {% if rpi012 %}
@ -259,7 +261,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image) .replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image) .replace('{image}', infos.image)
.replace('{version}', infos.version); .replace('{version}', infos.version);
if (!infos.file.startsWith("http")) if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file; infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -276,16 +278,17 @@ $(document).ready(function () {
}); });
</script> </script>
{% if not virtualbox %} {% if not virtualbox %}
{% if arm %} {% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flasher l'image {{image_type}} ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flasher l'image {{image_type}}
{% else %} {% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flasher l'image YunoHost ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flasher l'image YunoHost
{% endif %} {% endif %}
Maintenant que vous avez téléchargé l’image de {{image_type}}, vous devez la mettre sur {% if arm %}une carte microSD{% else %}une clé USB ou un CD/DVD.{% endif %} Maintenant que vous avez téléchargé l’image 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 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! [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). 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") 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 😉) 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] [/ui-tab]
@ -369,8 +371,15 @@ Allez dans **Réglages** > **Réseau** :
{% endif %} {% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Démarrer la carte ## [fa=plug /] Démarrer la carte
* Branchez le câble Ethernet (un côté sur votre box, l'autre côté à votre 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. * 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 %} {% elseif virtualbox %}
## [fa=plug /] Lancer la machine virtuelle ## [fa=plug /] Lancer la machine virtuelle
Démarrez votre machine virtuelle après avoir sélectionné l'image YunoHost. 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. ! 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 %} {% else %}
## [fa=plug /] Démarrer la machine sur la clé USB ## [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). * 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 l’une des touches suivantes (dépendant de votre ordinateur) : * 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 l’une des touches suivantes (dépendant de votre ordinateur) :
`<F9>`, `<F10>`, `<F11>`, `<F12>`, `<DEL>`, `<ESC>` ou <Alt>. `<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). !!! 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 %} {% endif %}
{% if regular or virtualbox %} {% if regular or virtualbox %}
## [fa=rocket /] Lancer l’installation graphique ## [fa=rocket /] Lancer l’installation graphique
Votre écran devrait ressembler à la capture ci-dessous : Votre écran devrait ressembler à la capture ci-dessous :
[figure class="nomargin" caption="Capture d'écran du menu de l'ISO"] [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. 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). 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
### Résumé des étapes en mode expert:
1. Sélectionnez `Expert graphical install` 1. Sélectionnez `Expert graphical install`
2. Sélectionnez votre langue, votre localisation, votre agencement de clavier et éventuellement votre timezone. 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. 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). 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 ### 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"). 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 ### A propos du RAID
Ne perdez pas de vue que: 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)
* 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é
* 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 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-tab]
[/ui-tabs] [/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". !!! 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 %} {% endif %}
{% if rpi012 %} {% if rpi012 %}
## [fa=bug /] Se connecter à la carte et corriger l'image ## [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). 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. 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`: 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 ssh root@yunohost.local
``` ```
(utilisez `yunohost-2.local`, etc. s'il y a plusieurs serveurs YunoHost sur le réseau) (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 : Ensuite, lancez les commandes suivantes pour contourner le dysfonctionnement de Metronome :
``` ```
mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.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 : Et celle-ci pour contourner celui de upnpc :
``` ```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py 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 :/ ! Cette dernière commande nécessite d'être lancée après chaque mise à jour de YunoHost :/
{% elseif arm_unsup %} {% elseif arm_unsup %}
## [fa=terminal /] Se connecter à la carte ## [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`. 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 %} {% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Lancer le script d'installation ## [fa=rocket /] Lancer le script d'installation
* Ouvrez la ligne de commande sur votre serveur (soit directement, soit avec [SSH](/ssh)) - 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) - Assurez-vous d'être connecté en tant que root (ou tapez `sudo -i` pour le devenir)
* Lancez la commande suivante : - Lancez la commande suivante :
```bash ```bash
curl https://install.yunohost.org | 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`. !!! 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` !!! 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 %} {% endif %}
## [fa=cog /] Lancer la configuration initiale ## [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). !!! 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 @@ C’est le nom de domaine qui permettra l’accès à votre serveur ainsi qu’a
##### [fa=key /] Premier compte utilisateur ##### [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. [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. 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 ## [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]
[ui-tab title="À partir de la ligne de commande"] [ui-tab title="À partir de la ligne de commande"]
``` ```
yunohost diagnosis run yunohost diagnosis run
yunohost diagnosis show --issues --human-readable yunohost diagnosis show --issues --human-readable
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/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]
[ui-tab title="À partir de la ligne de commande"] [ui-tab title="À partir de la ligne de commande"]
``` ```
yunohost domain cert install yunohost domain cert install
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/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) ! 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) !

98
pages/02.administer/10.install/install.md
View file

@ -132,21 +132,22 @@ Select the hardware on which you want install YunoHost :
[/div] [/div]
{% if hardware != '' %} {% if hardware != '' %}
{% if wsl %} {% 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. !! 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 %} {% endif %}
## [fa=list-alt /] Pre-requisites ## [fa=list-alt /] Pre-requisites
{% if regular %} {% if regular %}
* A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least) * A x86-compatible hardware dedicated to YunoHost: laptop, nettop, netbook, desktop with 512MB RAM and 16GB capacity (at least)
{% elseif rpi34 %} {% elseif rpi34 %}
* A Raspberry Pi 3 or 4 * A Raspberry Pi 3 or 4
{% elseif rpi012 %} {% 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 %} {% elseif internetcube %}
* An Orange Pi PC+ or an Olinuxino Lime 1 or 2 * An Orange Pi PC+ or an Olinuxino Lime 1 or 2
* A VPN with a dedicated public IP and a `.cube` file * 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 %} {% endif %}
{% if wsl %} {% if wsl %}
## Introduction ## 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. 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. 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` 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 ```bash
# In WSL # In WSL
@ -226,7 +225,6 @@ sudo apt update
sudo apt upgrade sudo apt upgrade
sudo apt dist-upgrade sudo apt dist-upgrade
``` ```
## Prevent WSL from tweaking configuration files ## Prevent WSL from tweaking configuration files
Edit `/etc/wsl.conf` and put the following code in it: 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: 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: 1. Install dotNET runtime:
```bash ```bash
# In WSL # In WSL
wget https://packages.microsoft.com/config/debian/11/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
@ -266,7 +263,6 @@ sudo apt install -y dotnet-sdk-3.1
``` ```
2. Install [Genie](https://github.com/arkane-systems/genie): 2. Install [Genie](https://github.com/arkane-systems/genie):
```bash ```bash
# In WSL # In WSL
# Add their repository # Add their repository
@ -295,10 +291,8 @@ Always call `genie -s` while starting your distro.
`wsl -d YunoHost -e genie -s` `wsl -d YunoHost -e genie -s`
## Backup and restore the distro ## Backup and restore the distro
### Make your first distro backup ### Make your first distro backup
As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell: 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 --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
``` ```
{% endif %} {% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## YunoHost VPS providers ## YunoHost VPS providers
Here are some VPS providers supporting YunoHost natively : 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-container"]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[/div] [/div]
{% endif %} {% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Download the {{image_type}} image ## [fa=download /] Download the {{image_type}} image
{% if rpi012 %} {% if rpi012 %}
@ -403,7 +396,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image) .replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image) .replace('{image}', infos.image)
.replace('{version}', infos.version); .replace('{version}', infos.version);
if (!infos.file.startsWith("http")) if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file; infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -420,16 +413,17 @@ $(document).ready(function () {
}); });
</script> </script>
{% if not virtualbox %} {% if not virtualbox %}
{% if arm %} {% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
{% else %} {% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
{% endif %} {% 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 %} 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... # Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0 dd if=/path/to/yunohost.img of=/dev/mmcblk0
``` ```
[/ui-tab] [/ui-tab]
{% if regular %} {% if regular %}
[ui-tab title="Burning a CD/DVD"] [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 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! [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). 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") 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 😉) 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] [/ui-tab]
@ -512,12 +504,19 @@ Go to **Settings** > **Network**:
{% endif %} {% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Power up the board ## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your 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 * 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. * (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 * 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. * Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
{% elseif virtualbox %} {% elseif virtualbox %}
## [fa=plug /] Boot up the virtual machine ## [fa=plug /] Boot up the virtual machine
Start the virtual machine after selecting the YunoHost image. 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. ! 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 ## [fa=plug /] Boot the machine on your USB stick
* Plug the ethernet cable (one side on your main router, the other on your server). * 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: * 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>`. `<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). !!! If you can't boot the Yunohost image, try using Ventoy (select "Ventoy" in the section "Flash the YunoHost image" above).
{% endif %} {% endif %}
{% if regular or virtualbox %} {% if regular or virtualbox %}
## [fa=rocket /] Launch the graphical install ## [fa=rocket /] Launch the graphical install
You should see a screen like this: 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. 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). 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
### Summary of the steps in expert mode:
1. Select `Expert graphical install`. 1. Select `Expert graphical install`.
2. Select your language, location, keyboard layout and possibly your timezone. 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. 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). 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 ### 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"). 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 ### About RAID
Keep in mind that: Keep in mind that:
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* 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
* 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
* 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-tab]
[/ui-tabs] [/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". !!! 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 %} {% endif %}
{% if rpi012 %} {% if rpi012 %}
## [fa=bug /] Connect to the board and hotfix the image ## [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). 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. 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`: 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 ssh root@yunohost.local
``` ```
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network) (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: Then run the following commands to work around the metronome issue:
``` ```
mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.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: And this one to work around the upnpc issue:
``` ```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py 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 :/ ! This last command need to be run after each yunohost upgrade :/
{% elseif arm_unsup %} {% elseif arm_unsup %}
## [fa=terminal /] Connect to the board ## [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`. 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 %} {% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Run the install script ## [fa=rocket /] Run the install script
* Open a command line prompt on your server (either directly or [through SSH](/ssh)) - 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) - Make sure you are root (or type `sudo -i` to become root)
* Run the following command: - Run the following command:
```bash ```bash
curl https://install.yunohost.org | 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. 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 ## [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. 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]
[ui-tab title="From the command line"] [ui-tab title="From the command line"]
``` ```
yunohost diagnosis run yunohost diagnosis run
yunohost diagnosis show --issues --human-readable yunohost diagnosis show --issues --human-readable
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/ui-tabs]
@ -810,15 +796,13 @@ Go in Domains > Click on your domain > SSL Certificate
[/ui-tab] [/ui-tab]
[ui-tab title="From the command line"] [ui-tab title="From the command line"]
``` ```
yunohost domain cert install yunohost domain cert install
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/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) ! 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) !

93
pages/02.administer/10.install/install.ru.md
View file

@ -132,21 +132,22 @@ routes:
[/div] [/div]
{% if hardware != '' %} {% if hardware != '' %}
{% if wsl %} {% if wsl %}
!! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет. !! Эта настройка в основном предназначена для локального тестирования продвинутыми пользователями. Из-за ограничений на стороне WSL (в частности, изменение IP-адреса) самостоятельный хостинг с него может быть сложным и здесь описываться не будет.
{% endif %} {% endif %}
## [fa=list-alt /] Предварительные условия ## [fa=list-alt /] Предварительные условия
{% if regular %} {% if regular %}
* x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее) * x86-совместимое оборудование, предназначенное для YunoHost: ноутбук, неттоп, нетбук, настольный компьютер с 512 МБ оперативной памяти и емкостью 16 ГБ (не менее)
{% elseif rpi34 %} {% elseif rpi34 %}
* Raspberry Pi 3 or 4 * Raspberry Pi 3 or 4
{% elseif rpi012 %} {% elseif rpi012 %}
* Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ * Raspberry Pi 0, 1 или 2 с ОЗУ не менее 512 МБ
{% elseif internetcube %} {% elseif internetcube %}
* Orange Pi PC+ или Olinuxino Lime 1 или 2 * Orange Pi PC+ или Olinuxino Lime 1 или 2
* VPN с выделенным общедоступным IP-адресом и файлом `.cube` * VPN с выделенным общедоступным IP-адресом и файлом `.cube`
@ -189,9 +190,7 @@ routes:
{% endif %} {% endif %}
{% if wsl %} {% 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. 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. 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` 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 ```bash
# In WSL # In WSL
@ -226,7 +225,6 @@ sudo apt update
sudo apt upgrade sudo apt upgrade
sudo apt dist-upgrade sudo apt dist-upgrade
``` ```
## Prevent WSL from tweaking configuration files ## Prevent WSL from tweaking configuration files
Edit `/etc/wsl.conf` and put the following code in it: 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: 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: 1. Install dotNET runtime:
```bash ```bash
# In WSL # In WSL
wget https://packages.microsoft.com/config/debian/11/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
@ -266,7 +263,6 @@ sudo apt install -y dotnet-sdk-3.1
``` ```
2. Install [Genie](https://github.com/arkane-systems/genie): 2. Install [Genie](https://github.com/arkane-systems/genie):
```bash ```bash
# In WSL # In WSL
# Add their repository # Add their repository
@ -295,10 +291,8 @@ Always call `genie -s` while starting your distro.
`wsl -d YunoHost -e genie -s` `wsl -d YunoHost -e genie -s`
## Backup and restore the distro ## Backup and restore the distro
### Make your first distro backup ### Make your first distro backup
As said before, there is no rollback capability. So let's export your fresh distro. In PowerShell: 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 --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2 wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2
``` ```
{% endif %} {% endif %}
{% if vps_ynh %}
{% if vps_ynh %}
## YunoHost VPS providers ## YunoHost VPS providers
Here are some VPS providers supporting YunoHost natively : 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-container"]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[div class="flex-child"] [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]
[/div] [/div]
{% endif %} {% endif %}
{% if at_home %}
{% if at_home %}
## [fa=download /] Download the {{image_type}} image ## [fa=download /] Download the {{image_type}} image
{% if rpi012 %} {% if rpi012 %}
@ -403,7 +396,7 @@ $(document).ready(function () {
.replace('%7Bimage%7D', infos.image) .replace('%7Bimage%7D', infos.image)
.replace('{image}', infos.image) .replace('{image}', infos.image)
.replace('{version}', infos.version); .replace('{version}', infos.version);
if (!infos.file.startsWith("http")) if (!infos.file.startsWith("http"))
infos.file="https://build.yunohost.org/"+infos.file; infos.file="https://build.yunohost.org/"+infos.file;
html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file); html = html.replace(/%7Bfile%7D/g, infos.file).replace(/{file}/g, infos.file);
@ -420,16 +413,17 @@ $(document).ready(function () {
}); });
</script> </script>
{% if not virtualbox %} {% if not virtualbox %}
{% if arm %} {% if arm %}
## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image ## ![microSD card with adapter](image://sdcard_with_adapter.png?resize=100,75&class=inline) Flash the {{image_type}} image
{% else %} {% else %}
## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image ## ![USB drive](image://usb_key.png?resize=100,100&class=inline) Flash the YunoHost image
{% endif %} {% 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 %} 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... # Replace /dev/mmcblk0 if the name of your device is different...
dd if=/path/to/yunohost.img of=/dev/mmcblk0 dd if=/path/to/yunohost.img of=/dev/mmcblk0
``` ```
[/ui-tab] [/ui-tab]
{% if regular %} {% if regular %}
[ui-tab title="Burning a CD/DVD"] [ui-tab title="Burning a CD/DVD"]
@ -500,12 +493,19 @@ Go to **Settings** > **Network**:
{% endif %} {% endif %}
{% if arm %}
{% if arm %}
## [fa=plug /] Power up the board ## [fa=plug /] Power up the board
* Plug the ethernet cable (one side on your main router, the other on your 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 * 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. * (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 * 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. * Make sure that your computer (desktop/laptop) is connected to the same local network (i.e. same internet box) as your server.
{% elseif virtualbox %} {% elseif virtualbox %}
## [fa=plug /] Boot up the virtual machine ## [fa=plug /] Boot up the virtual machine
Start the virtual machine after selecting the YunoHost image. 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. ! 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 ## [fa=plug /] Boot the machine on your USB stick
* Plug the ethernet cable (one side on your main router, the other on your server). * 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): * 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>`. `<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 %} {% endif %}
{% if regular or virtualbox %} {% if regular or virtualbox %}
## [fa=rocket /] Launch the graphical install ## [fa=rocket /] Launch the graphical install
You should see a screen like this: 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. 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). 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
### Summary of the steps in expert mode:
1. Select `Expert graphical install`. 1. Select `Expert graphical install`.
2. Select your language, location, keyboard layout and possibly your timezone. 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. 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). 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 ### 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"). 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 ### About RAID
Keep in mind that: Keep in mind that:
* the disks in your RAIDs must be of different brands, wear and tear or batches (especially if they are SSDs)
* 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
* 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
* 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-tab]
[/ui-tabs] [/ui-tabs]
{% endif %} {% endif %}
{% if rpi012 %} {% if rpi012 %}
## [fa=bug /] Connect to the board and hotfix the image ## [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). 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. 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`: 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 ssh root@yunohost.local
``` ```
(or `yunohost-2.local`, and so on if multiple YunoHost servers are on your network) (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: Then run the following commands to work around the metronome issue:
``` ```
mv /usr/bin/metronome{,.bkp} mv /usr/bin/metronome{,.bkp}
mv /usr/bin/metronomectl{,.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: And this one to work around the upnpc issue:
``` ```
sed -i 's/import miniupnpc/#import miniupnpc/g' /usr/lib/moulinette/yunohost/firewall.py 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 :/ ! This last command need to be run after each yunohost upgrade :/
{% elseif arm_unsup %} {% elseif arm_unsup %}
## [fa=terminal /] Connect to the board ## [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`. 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 %} {% endif %}
{% if vps_debian or arm_unsup %}
{% if vps_debian or arm_unsup %}
## [fa=rocket /] Run the install script ## [fa=rocket /] Run the install script
* Open a command line prompt on your server (either directly or [through SSH](/ssh)) - 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) - Make sure you are root (or type `sudo -i` to become root)
* Run the following command: - Run the following command:
```bash ```bash
curl https://install.yunohost.org | 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. 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 ## [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. 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]
[ui-tab title="From the command line"] [ui-tab title="From the command line"]
``` ```
yunohost diagnosis run yunohost diagnosis run
yunohost diagnosis show --issues --human-readable yunohost diagnosis show --issues --human-readable
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/ui-tabs]
@ -794,15 +781,13 @@ Go in Domains > Click on your domain > SSL Certificate
[/ui-tab] [/ui-tab]
[ui-tab title="From the command line"] [ui-tab title="From the command line"]
``` ```
yunohost domain cert install yunohost domain cert install
``` ```
[/ui-tab] [/ui-tab]
[/ui-tabs] [/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) ! 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) !