YunoHost Installieren

Wähle die Hardware, auf der du YunoHost installieren willst :

Pre-requisites

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.

Installation in Debian 12

Lass uns YunoHost in einem PowerShell Terminal in seine eigene Distro installieren und nicht die default Distro verändern:

# Geh in dein home Verzeichnis und bereite die Arbeitsverzeichnisse vor
cd ~
mkdir -p WSL\YunoHost
# Lade das Debian appx Paket herunter und entpacke es (unzip)
curl.exe -L -o debian.zip https://aka.ms/wsl-debian-gnulinux
Expand-Archive .\debian.zip -DestinationPath .\debian
# Importiere Debian als Grundlage in eine neue Distro
wsl --import YunoHost ~\WSL\YunoHost ~\debian\install.tar.gz --version 2
# Aufräumen
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 12 Bookworm machen:

# In WSL
sudo sed -i 's/stretch/bookworm/g' /etc/apt/sources.list`
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:

[network]
generateHosts = false
generateResolvConf = false

Erzwinge die Verwendung von iptables-legacy

Irgendwie mag die YunoHost Post-Installation nf_tables nicht, die neue Software ersetzt iptables. Wir können trotzdem immer noch explizit die guten alten iptables benutzen:

# In WSL
sudo update-alternatives --set iptables /usr/sbin/iptables-legacy
sudo update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy

Systemd installieren

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:

# In WSL
wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install -y apt-transport-https
sudo apt update
sudo apt install -y dotnet-sdk-3.1

2. Installation von Genie:

# In WSL
# Das repository hinzufügen
echo "deb [trusted=yes] https://wsl-translinux.arkane-systems.net/apt/ /" > /etc/apt/sources.list.d/wsl-translinux.list
# Genie installieren
sudo apt update
sudo apt install -y systemd-genie

YunoHost Installation

# In WSL
# zum root user wechseln, wenn you das nicht schon bist
sudo su
# Die Genie Flasche initialisiern, um systemd am Laufen zu haben 
genie -s
# Dein hostname sollte mit "-wsl" enden
# Installiere YunoHost
curl https://install.yunohost.org | bash -s -- -a

Öffne die Kommandozeile

Rufe genie -s immer während des Startes deiner Distro auf.

wsl -d YunoHost -e genie -s

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:

cd ~
wsl --export YunoHost .\WSL\YunoHost.tar.gz

Im Falle eines Crash, lösche und stelle die gesamte Distro wieder her

cd ~
wsl --unregister YunoHost
wsl --import YunoHost .\WSL\YunoHost .\WSL\YunoHost.tar.gz --version 2

Mit der Erstkonfiguration fortfahren

Haupt-Domain

Dies ist die Domäne, über die die Benutzer deines Servers auf das Authentifizierungsportal zugreifen. Du kannst später weitere Domains hinzufügen und bei Bedarf ändern, welche Domain die Haupt-Domain ist.

Du musst eine Fake-Domain wählen, da diese von außen nicht zugänglich ist. Zum Beispiel ynh.wsl. Der schwierige Teil besteht darin, diese Domain bei deinem Host zu bekannt zu machen.

Ändere deine C:\Windows\System32\drivers\etc\hosts Datei. Du solltest eine Zeile haben, die mit ::1 beginnt. Aktualisiere sie oder füge sie bei Bedarf hinzu, um Folgendes zu erhalten:

::1    ynh.wsl localhost

Wenn du Subdomains erstellen möchtest, denk daran, diese auch in der Datei hosts hinzuzufügen:

::1    ynh.wsl subdomain.ynh.wsl localhost

Der erste Benutzer

In dieser Phase wird der erste Benutzer erstellt. Du solltest einen Benutzernamen und ein einigermaßen komplexes Passwort wählen. (Wir können nicht genug betonen, dass das Passwort robust sein sollte!) Dieser Benutzer wird der Administratoren-Gruppe hinzugefügt und kann daher auf das Benutzerportal und die Webadministrationsoberfläche zugreifen und eine Verbindung über SSH oder SFTP herstellen. Administratoren erhalten außerdem E-Mails an root@yourdomain.tld und admin@yourdomain.tld: Diese E-Mails können zum Versenden technischer Informationen oder Warnungen verwendet werden. Du kannst später weitere Benutzer hinzufügen, die du auch zur Administratoren-Gruppe hinzufügen kannst.

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.

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.

Das Diagnosesystem soll eine einfache Möglichkeit bieten, zu überprüfen, ob alle kritischen Aspekte deines Servers ordnungsgemäß konfiguriert sind – und dich bei der Behebung von Problemen unterstützen. Die Diagnose wird zweimal täglich ausgeführt und sendet eine Warnung, wenn Probleme erkannt werden.

yunohost diagnosis run
yunohost diagnosis show --issues --human-readable

Ein Let's Encrypt Zertifikat holen

Sobald du die DNS-Einträge und die Portweiterleitung (falls erforderlich) konfiguriert hast, solltest du ein Let's Encrypt-Zertifikat einrichten können. Dadurch entfällt für neue Besucher die gruselige Sicherheitswarnung von vorhin.

Ausführlichere Anweisungen oder weitere Informationen zu SSL/TLS-Zertifikaten findest du hier auf der entsprechenden Seite.

yunohost domain cert install

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 zu werfen. Du solltest auch in der Lage sein, deine Lieblingsanwendungen zu installieren. Vergiss nicht, Backups zu planen!