YunoHost Installieren

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

Pre-requisites

  • Ein ARM Board mit mindestens 512MB RAM
  • Eine Spannungsversorung (entweder ein Netzteil oder ein MicroUSB Kabel) für dein Board;
  • Eine microSD Karte: 16GB Speicherkapazität (Minimum), class "A1" nachdrücklich empfohlen (so wie diese SanDisk A1 Karte);
  • Ein vernünftiger ISP, vorzugsweise mit einer guten und unbegrenzten Upstream Bandbreite
  • Ein Ethernet Kabel (RJ-45), um deinen Server mit deinem Router zu verbinden.
  • Ein Computer, um diese Anleitung zu lesen, das Image zu flashen und auf deinen Server zuzugreifen.
  • Lade das Armbian Image herunter

    Lade das Image für dein Board auf der Armbian Website herunter.

    Anmerkung: Du solltest das Image Armbian Bookworm downloaden.

    Wenn du die Validität deiner signierten Images prüfen will, kannst du unseren public key downloaden.

    microSD Karte mit Adapter Flash das Armbian Image

    Jetzt wo du das Image von Armbian heruntergeladen hast, solltest du es auf einer microSD Karte

    Lade Etcher für dein Betriebssystem herunter und installiere es.

    Steck die SD Karte an, wähle dein Image und klicke "Flash".

    Etcher

    Das Board einschalten

    • Schließe das Ethernet Kabel an (ein Ende an deinem Router, das andere an deinem Board).
      • Fortgeschrittene Nutzer, die das Board konfigurieren möchten, um sich stattdessen per WiFi zu verbinden, können bspw. hier nachlesen.
    • Stecke die SD Karte in dein Board.
    • (Optional) Du kannst Bildschirm+Tastatur direkt an deinem Board anschließen, wenn du Fehler am Boot Prozess beheben willst oder wenn du dich wohler fühlst zu "sehen was passiert" oder du direkten Zugriff auf das Board haben willst.
    • Schalte das Board ein.
    • Warte ein paar Minuten während sich das Board beim ersten Boot automatisch selbst konfiguriert.
    • Stelle sicher, dass dein Computer (Desktop/Laptop) mit dem selben lokalen Netzwerk verbunden ist (z.B. mit der selben Internet Box) wie dein Server.

    Verbindung zum Board

    Als nächstes musst du die lokale IP-Adresse deines Servers finden, um dich als Root-Benutzer über SSH mit dem temporären Passwort 1234 zu verbinden.

    ssh root@192.168.x.xxx

    Das Installationsskript ausführen

    • Öffne eine Kommandozeile auf deinem Server (entweder direkt oder über SSH)
    • Stelle sicher, dass du Root bist (oder gib „sudo -i“ ein, um Root zu werden)
    • Führe den folgenden Befehl aus:
    curl https://install.yunohost.org | bash

    Falls curl nicht auf deinem System installiert ist, kann es sein, dass du es mit apt install curl installieren musst. Falls der Befehl nichts bewirkt, kann es sein, dass du möglicherweise apt install ca-certificates ausführen musst.

    Hinweis für fortgeschrittene Benutzer, die sich mit dem curl|bash-Ansatz befassen approach: Ziehe das Lesen von "Ist curl|bash unsicher?" auf Sandstoms Blog und möglicherweise diese Diskussion auf Hacker News in Erwägung.

    Mit der Erstkonfiguration fortfahren

    Wenn du dabei bist, einen Server mithilfe eines YunoHost-Backups wiederherzustellen, solltest du diesen Schritt überspringen und anstelle des Postinstallationsschritts das Backup wiederherstellen.

    Gib in einem Internet Browser https://yunohost.local (oder yunohost-2.local usw., wenn mehrere YunoHost Server in deinem Netzwerk sind) ein.

    Wenn das nicht funktioniert, kannst du nach der lokalen IP-Adresse deines Servers suchen. Die Adresse sieht normalerweise wie 192.168.x.y aus und du solltest daher https://192.168.x.y in die Adressleiste deines Browsers eingeben.

    Beim ersten Besuch wirst du höchstwahrscheinlich auf eine Sicherheitswarnung bezüglich des vom Server verwendeten Zertifikats stoßen. Im Moment verwendet dein Server ein selbstsigniertes Zertifikat. Später kannst du ein von Webbrowsern automatisch erkanntes Zertifikat hinzufügen, wie in der Zertifikatdokumentation beschrieben ist. Zunächst solltest du eine Sicherheitsausnahme hinzufügen, um das aktuelle Zertifikat zu akzeptieren. (Aber BITTE gewöhne dir nicht an, diese Art von Sicherheitswarnung blind zu akzeptieren!)

    Dann solltest du auf dieser Seite landen:

    Initial configuration page

    Vorschau der Web-Erstkonfigurationsseite

    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.

    • Wenn du neu im Self-Hosting bist und noch keinen Domain-Namen hast, empfehlen wir die Verwendung eines .nohost.me / .noho.st / .ynh.fr (z.B. homersimpson.nohost.me). Sofern die Domain noch nicht vergeben ist, wird sie automatisch konfiguriert und du benötigst keinen weiteren Konfigurationsschritt. Bitte beachte, dass der Nachteil darin besteht, dass du nicht die vollständige Kontrolle über die DNS-Konfiguration hast.

    • Wenn du bereits einen Domain-Namen besitzt, möchtest du ihn wahrscheinlich hier verwenden. Später musst du DNS-Einträge konfigurieren, so wie hier beschrieben.

    Ja, du musst eine Domain-Namen konfigurieren. Wenn du keinen Domain-Namen hast und auch keine .nohost.me / .noho.st / .ynh.fr möchtest, kannst du eine Dummy-Domain einrichten wie yolo.test und passt deine lokale /etc/hosts Datei so an, dass diese Dummy-Domain auf die entsprechende IP verweist, wie hier erklärt.

    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.

    Anmerkung : Lauf nicht davon ! Wenn du die Diagnose zum ersten Mal ausführst, ist es durchaus zu erwarten, dass eine Reihe gelber/roter Warnungen angezeigt werden, da du normalerweise DNS-Einträge konfigurieren musst (wenn du keine .nohost.me/noho.st/ynh.fr Domain verwendest). Lege ein Swapfile an, wenn nicht genügend RAM vorhanden ist und/oder richte Portweiterleitung ein.

    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.

    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:

    Vorschau des Diagnosepanels

    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.

    Gehe zu Domains > Klicke auf deine Domain > SSL Zertifikat

    Vorschau des Diagnosepanels

    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!

    Fehler gefunden? Möchten Sie diese Seite verbessern? Einfach dem Edit Link am Anfang der Seite folgen und dann auf das Symbol auf Github clicken um Änderungen vorzuschlagen.