Zum Inhalt springen
CloudZH

Doku / Kundenanleitung

Schritt 6 von 10

CloudZH installieren

Kopiere den Installer auf den Server, starte ihn und gib deinen Lizenzschlüssel ein. Der Installer selbst braucht 5 bis 10 Minuten.

Einfacher:

Im Kundenkonto einen fertigen Befehl erstellen und im Browser weitermachen. Siehe CloudZH Setup im Browser.

Du brauchst die Installer-Datei aus Meine Lizenzen → Installer herunterladen in deinem Kundenkonto und deine Lizenz-E-Mail. <user> und <server-ip> stammen aus Schritt 4; <file> ist der Name der Installer-Datei, zum Beispiel cloudzh-0.77.5-stable-customer.tar.gz.

  1. Installer auf den Server kopieren

    Auf deinem Computer, im Ordner mit dem Installer (Windows: PowerShell, zum Beispiel nach cd Downloads):

    scp <file> <user>@<server-ip>:~
  2. Entpacken und starten

    ssh <user>@<server-ip>
    mkdir -p ~/cloudzh && tar xzf ~/<file> -C ~/cloudzh --strip-components=1
    cd ~/cloudzh && sudo bash install.sh

    sudo fragt nach dem Passwort von <user>.

  3. Fragen beantworten

    FrageAntwort
    Domain (leer lassen für LAN-Modus)Deine Domain oder leer für den LAN-Modus
    Subdomain fürs DashboardZum Beispiel app; Enter behält dash
    E-Mail für Let's EncryptDeine E-Mail-Adresse
    Cloudflare-API-TokenFüge den Token ein. Er bleibt beim Tippen unsichtbar; der Installer prüft ihn bei Cloudflare.
    Zentraler DatenordnerEnter, für /srv/data
    Lizenzschlüssel (CZL-…)Ein Lizenzschlüssel aus deiner E-Mail oder aus Meine Lizenzen. Jeder Server braucht seinen eigenen Schlüssel.

    Nach der Installation bekommst du eine E-Mail Neuen Server bestätigen. Prüfe, dass der Vergleichscode mit dem auf deinem Server übereinstimmt, und klicke auf Ja, das bin ich; der Server aktiviert sich von selbst. Mit CloudZH Setup aus deinem Kundenkonto gibt es nichts zu bestätigen.

    Subdomain, E-Mail und Cloudflare-Token werden nur im Domain-Modus abgefragt. Lass den Lizenzschlüssel leer, um später mit sudo zh license activate CZL-… zu aktivieren; bis dahin läuft CloudZH im eingeschränkten Modus.

  4. Backup-Schlüssel sichern

    Am Ende zeigt der Installer die Dashboard-Adresse und einen Einrichtungs-Token. Kopiere den Backup-Schlüssel in deinen Passwortmanager; ohne ihn lassen sich Backups nicht öffnen:

    sudo cat /etc/cloudzh/backup.key

    Lagen in /srv/data schon Medien? Dann führe zusätzlich sudo chown -R cloudzh:cloudzh /srv/data aus.

  5. Zum ersten Mal anmelden

    Öffne die Dashboard-Adresse: https://app.example.com mit Domain, http://<server-ip> im LAN-Modus. Gib den Einrichtungs-Token ein und lege deinen Administrator an. Token verloren? zh token zeigt ihn erneut.

  6. Prüfen

    Melde dich einmal von SSH ab und wieder an, dann:

    zh status
    zh doctor

    Mein Konto → Abonnement im Dashboard zeigt die Lizenz dieses Servers.