Zum Inhalt springen
CloudZH

Doku / Hilfe

FAQ

Klare Antworten für alle, die ihre eigenen Server betreiben. Alles hier beschreibt, was CloudZH heute tut.

Warum kostet CloudZH Geld, und warum ist es nicht Open Source?

CloudZH wird von einer Person entwickelt und betreut. Das Abo bezahlt diese Arbeit: neue Versionen, Sicherheitskorrekturen, den App Store, den Lizenz- und Update-Dienst und Antworten auf deine Fragen. Eine bezahlte Lizenz heisst: Alle Kunden bekommen dasselbe vollständige Produkt, ohne Open Core, Werbung oder Datenverkauf, und das Projekt kann weitergehen. Die Apps, die CloudZH installiert, sind die bekannten Open-Source-Projekte in ihren offiziellen Images, und du behältst root auf deinem Server: Jeder Container, jede Datei und jede Einstellung bleibt für dich sichtbar.

Was sendet mein Server an den Lizenzdienst?

Einmal am Tag meldet sich der Server bei license.cloudzh.app. Die signierte Anfrage enthält genau:

  • die zufällige ID des Servers und einen Zeitstempel,
  • seinen Hostnamen und die CloudZH-Version,
  • einen Hardware-Fingerabdruck: einen Hash aus Machine-ID und Mainboard-UUID, nie die Werte selbst,
  • drei Zahlen: Dashboard-Benutzer, Administratoren und installierte Apps.

Die Antwort ist eine frische, signierte Lizenzdatei. Bei der Aktivierung sendet der Server zusätzlich seinen öffentlichen Schlüssel. Die Update-Prüfung nutzt dieselbe signierte Anfrage. Feedback und Fernsupport senden nur etwas, wenn du sie startest.

Was wird nie gesendet?

Deine Medien und Dateien, Datei- und Ordnernamen, Passwörter, API-Schlüssel, Namen und E-Mail-Adressen deiner Benutzer, App-Einstellungen, deine Mediathek und Logs, ausser du hängst selbst etwas an eine Anfrage. Der KI-Assistent ist die einzige Funktion, die Inhalte sendet, und nur an den KI-Anbieter, den du mit deinem eigenen Schlüssel eingerichtet hast.

Wie lange läuft mein Server ohne Internet?

14 Tage ohne jede Änderung. So lange gilt die Lizenzdatei; nach drei verpassten täglichen Meldungen zeigt das Dashboard einen Hinweis. Nach 14 Tagen ohne Kontakt wechselt der Server in den eingeschränkten Modus. Plex, deine Apps, das VPN und die Backups laufen die ganze Zeit weiter, auch im eingeschränkten Modus, und alles ist zurück, sobald der Server den Lizenzdienst wieder erreicht.

Was passiert im eingeschränkten Modus?

Der Server arbeitet wie Standard: keine Funktions-Updates von CloudZH, keine neuen Apps, keine neuen Benutzer oder Einladungslinks, und nur der Besitzer meldet sich an. Alles Bestehende läuft weiter: Plex und alle Apps, die Mediathek, VPN, Backups, Starten und Stoppen. Sicherheits-Updates von CloudZH, Image-Updates deiner bestehenden Apps und das Wiederherstellen eines Backups bleiben möglich. Nichts wird gelöscht. Der eingeschränkte Modus gilt, wenn ein Abo abgelaufen ist (bezahlte Pläne nach 7 Tagen Zahlungsfrist), eine Lizenz pausiert oder widerrufen ist, der Server freigegeben wurde oder nach 14 Tagen ohne Kontakt.

Wo sind meine Daten?

Auf deinem Server. Medien, Dateien, Konten, App-Daten, Logs und Backups bleiben auf deiner Hardware oder auf dem Backup-Ziel, das du wählst, etwa deinem NAS, deinem S3-Bucket oder deinem Cloud-Speicher. Wir haben keinen Zugriff auf deinen Server und keine Kopie deiner Daten. Fernsupport gibt es nur, wenn du ihn startest, für die Zeit, die du wählst.

Welche Hardware und welche Systeme?

Ein 64-Bit-Rechner (Intel, AMD oder ARM, zum Beispiel ein Mini-PC oder ein Raspberry Pi 4 oder 5) mit Ubuntu Server 24.04 LTS (empfohlen), Ubuntu 22.04 oder 26.04, Debian 12 oder 13 oder Raspberry Pi OS 64-Bit. Proxmox (VM oder LXC), ein VPS sowie Synology, UGREEN, QNAP, TrueNAS oder Unraid als VM gehen auch; Windows 10 und 11 laufen als Beta über WSL2. Nicht unterstützt: Fedora, Arch und andere Systeme ausserhalb der Debian-Familie, macOS und 32-Bit-ARM. Details: Voraussetzungen.

Standard oder Pro?

Beide betreiben jede App mit allen Sicherheitsfunktionen. Standard hat ein Dashboard-Konto, für dich; deine Familie schaut weiter über die Freigabe in Plex oder Jellyfin. Pro bringt Konten für Familie und Freunde, Einladungs- und Gastlinks, Backups ausser Haus, automatische Updates, den KI-Assistenten, eigene Apps, dein eigenes Branding, den Aktivitätsverlauf, alle Benachrichtigungskanäle und Priority Support. Ein Wechsel löscht nie etwas. Vollständiger Vergleich: Lizenzierung.

Kündigen, Rückerstattung, Umzug, Deinstallation

  • Kündigen jederzeit in deinem Konto auf account.cloudzh.app. Das Abo läuft bis zum Ende der bezahlten Periode, danach läuft der Server im eingeschränkten Modus weiter.
  • Rückerstattung: keine freiwilligen Rückerstattungen für ungenutzte Zeit. Abrechnungsfehler, Mängel, die wir nicht beheben können, und das 14-tägige Widerrufsrecht für Verbraucher in der EU, im EWR und im Vereinigten Königreich sind abgedeckt. Details: Rückerstattungsrichtlinie.
  • Neue Hardware: CloudZH Move kopiert Apps, Einstellungen und die Lizenz auf den neuen Server, oder du gibst den alten Server in deinem Konto frei und aktivierst den neuen. Siehe Umziehen oder neu installieren.
  • Deinstallieren: sudo zh uninstall gibt den Lizenzplatz frei und zeigt die Befehle, um CloudZH zu entfernen. Deine Apps und Daten bleiben, bis du sie selbst löschst.

Sendet der KI-Assistent meine Daten irgendwohin?

Nur wenn du ihn einschaltest, und nur mit deinem eigenen API-Schlüssel beim KI-Anbieter deiner Wahl. Der Schlüssel liegt verschlüsselt auf deinem Server, Anfragen gehen von deinem Server direkt an diesen Anbieter und nie über uns, und Geheimnisse werden vor dem Senden entfernt. Der Assistent schlägt nur Aktionen vor; sie laufen erst, wenn du sie bestätigst. Er gehört zu Pro.

Bringt CloudZH Indexer oder Inhalte mit?

Nein. CloudZH liefert Open-Source-Apps, wie sie sind, und enthält keine Medien, keine Indexer, keine Usenet-Anbieter und keine anderen Quellen. Du fügst deine eigenen hinzu. Was du herunterlädst und teilst, liegt in deiner Verantwortung: Nutze CloudZH nur für Inhalte, die du nutzen darfst.

Wie funktioniert der Support, und wann antwortet ihr?

  • Pro: Antwort innerhalb von 3 Stunden zwischen 08:00 und 22:00 Uhr (Zürcher Zeit); Anfragen ausserhalb dieser Zeit beantworten wir am nächsten Morgen.
  • Standard: Antwort innerhalb von 24 Stunden.
  • Kanäle: Anfragen in deinem Konto auf account.cloudzh.app (Pro-Anfragen sind markiert und kommen zuerst), E-Mail an [email protected] und Discord für Hilfe aus der Community.

CloudZH ist ein Ein-Personen-Projekt. Die Zeiten gelten für eine erste persönliche Antwort, nicht für die Lösung. Siehe Hilfe bekommen.

Was passiert, wenn CloudZH eingestellt wird?

Sollten wir den Lizenzdienst je abschalten, kündigen wir das mindestens 90 Tage vorher per E-Mail an. Bevor er offline geht, bekommen Kunden mit gültiger Lizenz ein letztes Update, das die Lizenzprüfung entfernt und alle Funktionen des gekauften Plans dauerhaft freischaltet. Deine Daten und Apps sind davon nicht betroffen. Das steht in Abschnitt 17 der AGB.