Installation

Environ 15 minutes d’un Ubuntu tout neuf à la première connexion.

1:28CloudZH SetupCollez une commande depuis votre compte client, puis installez étape par étape dans votre navigateur.

<user> est l’utilisateur Linux que tu as créé lors de l’installation d’Ubuntu, <server-ip> l’adresse du serveur dans ton réseau domestique, par exemple 192.168.1.200. Sur le serveur, ip -4 -br addr l’affiche sur la ligne de l’adaptateur réseau. Plus d’infos dans Valeurs à remplacer.

CloudZH Setup dans le navigateur

Le moyen le plus rapide, sans copier de fichier ni répondre à des questions dans le terminal :

1. Copie ta commande

   Dans ton compte client, sous Mes licences → CloudZH Setup, clique sur Créer la commande et copie-la. Elle est personnelle, valable 24 heures et sert pour 3 téléchargements au maximum.

2. Colle-la sur le serveur

   Par SSH ou directement à l'écran du serveur. Elle télécharge l'installateur, vérifie sa somme SHA-256 et lance l'assistant :

   curl -fsSL https://account.cloudzh.app/i/<your-code> | sudo bash

3. Continue dans le navigateur

   Ouvre l'adresse affichée dans le terminal sur un PC, un portable ou un téléphone du même réseau, par exemple http://192.168.1.200:8000. L'assistant vérifie le système, demande LAN ou domaine, le dossier de données et tes clés de licence, installe avec une barre de progression en direct et te donne la clé de sauvegarde à télécharger. Ouvrir le tableau de bord remplit le jeton de configuration pour toi.

   Il ne répond qu'aux appareils de ton réseau local, demande le code d'accès du terminal et continue si tu fermes la fenêtre SSH. Fichier d'installation déjà copié ? sudo bash install.sh --web lance le même assistant.

Installer dans le terminal

Pour les experts, ou pour répondre aux questions en ligne de commande.

1. Mettre à jour Ubuntu

   sudo apt update && sudo apt full-upgrade -y
   sudo reboot

2. Copier l’installateur sur le serveur

   Télécharge l’installateur dans ton compte client sous My licences → Download installer, un fichier nommé par exemple cloudzh-0.77.5-stable-customer.tar.gz. La page affiche aussi sa somme de contrôle SHA-256. Copie-le depuis ton ordinateur, puis décompresse-le sur le serveur. <file> est le nom du fichier de l’installateur :

   scp <file> <user>@<server-ip>:~
   ssh <user>@<server-ip>
   mkdir -p ~/cloudzh && tar xzf ~/<file> -C ~/cloudzh --strip-components=1
   cd ~/cloudzh

3. Lance l’installateur

   sudo bash install.sh

   L'installateur demande ton domaine (laisse vide pour le mode LAN), le jeton Cloudflare et ta clé de licence. Confirme ensuite le nouveau serveur dans l'e-mail que nous t'envoyons, ou dans ton compte client sous Licences ; le serveur s'active tout seul. Pour passer la clé sans questions :

   sudo CZH_LICENSE_KEY=CZL-XXXXX-XXXXX-XXXXX-XXXXX bash install.sh

   À la fin, il affiche l’adresse du tableau de bord, un jeton de configuration et, sur un nouveau serveur, l’emplacement de la clé de sauvegarde. Enregistre la clé de sauvegarde dans ton gestionnaire de mots de passe ; sans elle, les sauvegardes ne peuvent pas être ouvertes :

   sudo cat /etc/cloudzh/backup.key

4. Se connecter et vérifier

   Ouvre l’adresse du tableau de bord, saisis le jeton de configuration et crée ton administrateur. Jeton perdu ? zh token l’affiche à nouveau. Ensuite, sur le serveur :

   zh status
   zh doctor

   Continue avec Domaine & HTTPS et Premiers pas.

Ce que l’installateur met en place

• Docker, Caddy, le tableau de bord et l’agent comme services systemd
• L’arborescence de données sous /srv/data (voir Organisation des données)
• Fail2Ban et l’accueil SSH avec un court état
• Le kit de diagnostic : test de débit, mtr, iperf3, dig, smartctl, sensors, ethtool, iw, htop, ncdu
• La commande zh pour chaque utilisateur avec les droits sudo