Zum Inhalt springen
CloudZH

Doku / Referenz

Lizenzierung

Eine Lizenz pro Server, monatlich oder jährlich, als Standard oder Pro; das Haushalt-Abo deckt bis zu 3 Server ab. Verwalte sie in deinem Konto auf account.cloudzh.app.

Kaufen

Kaufe in deinem Konto auf account.cloudzh.app unter Kaufen; die Knöpfe unter Preise auf dieser Website führen ebenfalls dorthin. Wähle monatlich oder jährlich und die Anzahl Server. Ein Abo deckt alle deine Server ab; die Anzahl änderst du später unter Meine Lizenzen. Die Zahlung wickelt Link (Sold through Link, LLC, a Stripe company) als Merchant of Record ab. Deine Lizenzschlüssel, einer pro Server, kommen automatisch per E-Mail, meist innert Minuten, und stehen unter Meine Lizenzen. Test- und Geschenkcodes löst du in deinem Konto unter Code einlösen ein. Schritt für Schritt: Lizenz holen. Siehe die AGB und die Rückerstattungsrichtlinie.

Standard und Pro

BereichStandardPro
Apps, Mediathek, Einrichtungsassistenten, TRaSHAlleAlle
Sicherheit: 2FA, Passkeys, VPN, Firewall, Warnungen bei neuen GerätenAlleAlle
Dashboard-KontenEines, für dich (Teilen über Plex und Jellyfin funktioniert wie gewohnt)Konten für Familie und Freunde, Einladungslinks, Gastkonten mit Ablaufdatum, weitere Admins
Backups und Updates mit RollbackVerschlüsselt, auf dem Server, einer zweiten Disk oder einem NASDazu S3 und Cloud-Speicher, Download im Browser, automatische Updates, App-Rollback
BenachrichtigungenEin Kanal, StandardschwellenAlle Kanäle, eigene Schwellen, Ruhezeit
Aktivitätsverlauf, Leistungsdiagnose, KI-Assistent, eigene Apps, Homelab-Extras–Inklusive
AussehenHell oder dunkel, Dichte, Sprache, FormateDazu eigener Name, Logo, Farben, Anmeldeseite und Menünamen
SupportDiscord und Support-AnfragenAnfragen werden zuerst beantwortet

Eine kostenlose Testlizenz hat immer die Pro-Funktionen. Kostenlose Lizenzen aus Tests, Aktionen und Geschenken kannst du in deinem Konto oder Dashboard kaufen: gleiche Lizenz, gleicher Server, und die restlichen Gratistage bleiben. Ein Wechsel von Pro zu Standard löscht nie etwas: Konten und Einstellungen bleiben, aber nur der Besitzer kann sich anmelden, und Pro-Funktionen pausieren, bis du zurückwechselst.

Schlüssel

SchlüsselFormatVerwendung
LizenzschlüsselCZL-XXXXX-XXXXX-XXXXX-XXXXXEiner pro Server. Jeder Schlüssel aktiviert genau einen Server. Gib ihn nicht weiter.

Ein Lizenzschlüssel allein aktiviert keinen Server: Jeder neue Server braucht dein OK per E-Mail oder in deinem Konto, ausser er kommt aus CloudZH Setup in deinem Konto. Unter Meine Lizenzen siehst du deine Schlüssel nach Bestätigung mit Passwort oder Passkey, schickst sie dir per E-Mail oder ersetzt einen einzelnen Schlüssel; der Server damit läuft weiter. Siehe Deine Lizenz-E-Mail.

Check-in

Der Server meldet sich einmal am Tag und erhält eine signierte Lizenzdatei. Er sendet seine Server-ID, die CloudZH-Version und einen Hardware-Fingerabdruck.

Zustände

ZustandWirkung
Aktiv, endet baldAlles funktioniert, Erinnerung 14 Tage vorher
ZahlungsfristNur bezahlte Abos: 7 Tage nach dem Ende funktioniert alles, Banner
Kein Kontakt zum Lizenzdienst14 Tage normal, Banner nach 3 verpassten Check-ins
Abgelaufen, pausiert, widerrufen, freigegebenEingeschränkter Modus, läuft wie Standard
Nicht aktiviertEingeschränkter Modus

Eingeschränkter Modus

Pausiert: CloudZH-Funktionsupdates, neue Apps, neue Benutzer und Einladungslinks. Der Server läuft wie Standard: weitere Konten und Pro-Funktionen pausieren, nur der Besitzer meldet sich an. Läuft weiter: Plex, alle installierten Apps, VPN, lokale Backups und ein schon eingerichtetes Backup ausser Haus, App-Image-Updates, Backups wiederherstellen (fehlende Apps werden nicht installiert), CloudZH-Sicherheitsupdates (nicht bei widerrufener oder pausierter Lizenz), Terminal und Dateien. Gelöscht wird nichts; mit aktiver Lizenz ist alles sofort zurück.

Neue Hardware

Eine Lizenz zählt einen aktiven Server. Für einen Umzug gibst du den alten Server frei (Meine Lizenzen in deinem Konto, sudo zh license deactivate oder Mein Konto → Abonnement im Dashboard) und aktivierst den neuen Server mit demselben Lizenzschlüssel, der jetzt frei ist. Details: Umziehen oder neu installieren.

Ändert sich die Hardware ohne Freigabe, läuft der Server weiter und zeigt Hardware geändert. Nutzen zwei Maschinen dieselbe Lizenz, behält sie nur eine.

zh license            # license of this server
sudo zh license activate CZL-…   # activate this server with a license key
zh license refresh               # check in with the license service now
sudo zh license deactivate       # release this server, its key becomes free