Prérequis

Ce dont la machine, ton réseau et ton domaine ont besoin avant de lancer l’installateur.

Serveur

Système d’exploitation : Ubuntu Server 24.04 LTS, 64 bits Intel ou AMD (x86-64). Pars d’une installation neuve.
Processeur et mémoire : au moins 4 cœurs et 8 Go, 16 Go si UniFi OS Server tourne aussi. Prévois davantage pour Immich, Tdarr ou beaucoup d’utilisateurs en streaming simultané.
Disques : un SSD pour le système, et un disque séparé ou un NVMe pour tes médias, monté sur /srv/data.
Accès : un utilisateur avec les droits sudo et SSH.

Branche le serveur par câble. Le Wi-Fi fonctionne, mais les téléchargements, Plex et le VPN en pâtissent, et un contrôleur UniFi ne doit jamais dépendre de son propre point d’accès.
Donne au serveur une adresse fixe dans ton routeur (réservation DHCP), par exemple 192.168.1.200. La doc l’appelle <server-ip>, voir Préparer le serveur.
Avec un domaine, redirige TCP 443 de ton routeur vers le serveur. Pour le VPN, aussi UDP 51820.
L'accès depuis l'extérieur nécessite une adresse IPv4 publique propre. Beaucoup de lignes câble et fibre, Starlink et les routeurs LTE/5G partagent une adresse entre clients (CGNAT, DS-Lite), et la redirection de ports n'y a aucun effet. L'installateur le vérifie, voir Accessibilité, CGNAT et DynDNS.

Facultatif. Sans domaine, CloudZH fonctionne en mode LAN, uniquement dans ton réseau domestique. Voir Domaine ou réseau domestique.

Un domaine dont la zone DNS est gérée par Cloudflare.
Un jeton API Cloudflare avec l’autorisation Zone · DNS · Edit pour cette zone. N’utilise pas la Global API Key.

Ta clé de licence (CZL-XXXXX-XXXXX-XXXXX-XXXXX) issue de ton e-mail de licence. Un nouveau serveur se confirme par e-mail, ou utilise CloudZH Setup depuis ton compte client, sans confirmation.