Zum Inhalt springen
CloudZH
Kaufen
DE
EnglishENDeutschDEFrançaisFREspañolESPortuguêsPTTürkçeTR

Doku / Erste Schritte

Installation

Etwa 15 Minuten von einem frischen Ubuntu bis zur ersten Anmeldung.

Zum ersten Mal hier?

Die Kundenanleitung erklärt jeden Schritt, von deinem Konto und der Lizenz-E-Mail bis zu Ubuntu und der ersten Anmeldung.

<user> ist der Linux-Benutzer, den du bei der Installation von Ubuntu angelegt hast, <server-ip> die Adresse des Servers in deinem Heimnetz, zum Beispiel 192.168.1.200. Auf dem Server zeigt ip -4 -br addr sie in der Zeile des Netzwerkadapters. Mehr unter Platzhalter.

CloudZH Setup im Browser

Der schnellste Weg, ohne Dateien zu kopieren und ohne Fragen im Terminal:

  1. Befehl kopieren

    In deinem Kundenkonto unter Meine Lizenzen → CloudZH Setup auf Befehl erstellen klicken und ihn kopieren. Er ist persönlich, 24 Stunden gültig und reicht für höchstens 3 Downloads.

  2. Auf dem Server einfügen

    Über SSH oder direkt am Bildschirm des Servers. Er lädt den Installer, prüft die SHA-256-Prüfsumme und startet den Einrichtungsassistenten:

    curl -fsSL https://account.cloudzh.app/i/<your-code> | sudo bash

  3. Im Browser weitermachen

    Die Adresse aus dem Terminal auf einem PC, Laptop oder Handy im selben Netz öffnen, zum Beispiel http://192.168.1.200:8000. Der Assistent prüft das System, fragt nach LAN oder Domain, Datenordner und Lizenzschlüsseln, installiert mit Live-Fortschritt und gibt dir den Backup-Schlüssel zum Herunterladen. Zum Dashboard füllt den Einrichtungs-Token für dich aus.

    Er antwortet nur Geräten im Heimnetz, braucht den Zugangscode aus dem Terminal und läuft weiter, wenn du das SSH-Fenster schliesst. Installer-Datei schon kopiert? sudo bash install.sh --web startet denselben Assistenten.

Im Terminal installieren

Für Profis, oder um die Fragen in der Kommandozeile zu beantworten.

  1. Ubuntu aktualisieren

    sudo apt update && sudo apt full-upgrade -y
sudo reboot

  2. Installer auf den Server kopieren

    Lade den Installer in deinem Kundenkonto unter Meine Lizenzen → Installer herunterladen herunter, eine Datei mit einem Namen wie cloudzh-0.77.5-stable-customer.tar.gz. Die Seite zeigt auch die SHA-256-Prüfsumme. Kopiere ihn von deinem Computer hinüber und entpacke ihn dann auf dem Server. <file> ist der Name der Installer-Datei:

    scp <file> <user>@<server-ip>:~
ssh <user>@<server-ip>
mkdir -p ~/cloudzh && tar xzf ~/<file> -C ~/cloudzh --strip-components=1
cd ~/cloudzh

  3. Installer starten

    sudo bash install.sh

    Der Installer fragt nach deiner Domain (leer lassen für den LAN-Modus), dem Cloudflare-Token und deinem Lizenzschlüssel. Danach bestätigst du den neuen Server in der E-Mail, die wir dir schicken, oder in deinem Kundenkonto unter Lizenzen; der Server aktiviert sich von selbst. Den Schlüssel ohne Rückfrage übergeben:

    sudo CZH_LICENSE_KEY=CZL-XXXXX-XXXXX-XXXXX-XXXXX bash install.sh

    Am Ende zeigt er die Dashboard-Adresse, einen Einrichtungs-Token und, auf einem neuen Server, wo der Backup-Schlüssel liegt. Speichere den Backup-Schlüssel in deinem Passwortmanager; ohne ihn lassen sich Backups nicht öffnen:

    sudo cat /etc/cloudzh/backup.key

  4. Anmelden und prüfen

    Öffne die Dashboard-Adresse, gib den Einrichtungs-Token ein und lege deinen Administrator an. Token verloren? zh token zeigt ihn erneut. Dann auf dem Server:

    zh status
zh doctor

    Weiter mit Domain & HTTPS und Erste Schritte.

Was der Installer einrichtet

  • Docker, Caddy, das Dashboard und den Agenten als systemd-Dienste
  • Den Datenbaum unter /srv/data (siehe Datenstruktur)
  • Fail2Ban und die SSH-Begrüssung mit einem kurzen Status
  • Die Diagnose-Werkzeuge: Speedtest, mtr, iperf3, dig, smartctl, sensors, ethtool, iw, htop, ncdu
  • Den Befehl zh für jeden Benutzer mit sudo-Rechten
Schon installiert?

Aktiviere eine Lizenz auf einem bestehenden Server mit sudo zh license activate CZL-… oder im Dashboard unter Mein Konto → Abonnement.