Zum Inhalt springen
CloudZH

Doku / Erste Schritte

Voraussetzungen

Was der Rechner, dein Netz und deine Domain brauchen, bevor du den Installer startest.

Server

  • Betriebssystem: Ubuntu Server 24.04 LTS, 64-Bit Intel oder AMD (x86-64). Beginne mit einer frischen Installation.
  • Prozessor und Arbeitsspeicher: mindestens 4 Kerne und 8 GB, 16 GB, wenn auch UniFi OS Server läuft. Plane mehr ein für Immich, Tdarr oder viele Benutzer, die gleichzeitig streamen.
  • Disks: eine SSD für das System und eine separate Disk oder NVMe für deine Medien, eingehängt unter /srv/data.
  • Zugang: ein Benutzer mit sudo-Rechten und SSH.

Netz

  • Schliess den Server per Kabel an. WLAN funktioniert, aber Downloads, Plex und das VPN leiden darunter, und ein UniFi-Controller darf nie von seinem eigenen Access Point abhängen.
  • Gib dem Server in deinem Router eine feste Adresse (DHCP-Reservierung), zum Beispiel 192.168.1.200. Die Doku nennt sie <server-ip>, siehe Server vorbereiten.
  • Mit Domain leitest du TCP 443 im Router an den Server weiter. Für das VPN zusätzlich UDP 51820.
  • Zugriff von aussen braucht eine eigene öffentliche IPv4-Adresse. Viele Kabel- und Glasfaseranschlüsse, Starlink und LTE/5G-Router teilen sich eine Adresse mit anderen Kunden (CGNAT, DS-Lite), dort wirkt eine Portweiterleitung nicht. Der Installer prüft das, siehe Erreichbarkeit, CGNAT & DynDNS.

Domain

Optional. Ohne Domain läuft CloudZH im LAN-Modus, nur in deinem Heimnetz. Siehe Domain oder Heimnetz.

  • Eine Domain, deren DNS-Zone bei Cloudflare verwaltet wird.
  • Ein Cloudflare-API-Token mit der Berechtigung Zone · DNS · Edit für diese Zone. Verwende nicht den Global API Key.

Lizenz

  • Dein Lizenzschlüssel (CZL-XXXXX-XXXXX-XXXXX-XXXXX) aus deiner Lizenz-E-Mail. Einen neuen Server bestätigst du per E-Mail, oder du nutzt CloudZH Setup aus deinem Kundenkonto, dann ist keine Bestätigung nötig.

Optionale Konten

  • Ein Plex-Konto, ein Usenet-Anbieter und mindestens ein Usenet-Indexer.
  • Ein API-Schlüssel eines KI-Anbieters, wenn du den Assistenten nutzen willst.