Aller au contenu
CloudZH

Docs / Guide client

Étape 6 sur 10

Installer CloudZH

Copie l’installateur sur le serveur, lance-le et saisis ta clé de licence. L’installateur lui-même prend 5 à 10 minutes.

Plus simple :

Crée une commande prête à l'emploi dans ton compte et continue dans le navigateur. Voir CloudZH Setup dans le navigateur.

Il te faut le fichier de l’installateur depuis My licences → Download installer dans ton compte client et ton e-mail de licence. <user> et <server-ip> viennent de l’étape 4 ; <file> est le nom du fichier de l’installateur, par exemple cloudzh-0.77.5-stable-customer.tar.gz.

  1. Copier l’installateur sur le serveur

    Sur ton ordinateur, dans le dossier contenant l’installateur (Windows : PowerShell, par exemple après cd Downloads) :

    scp <file> <user>@<server-ip>:~
  2. Décompresser et lancer

    ssh <user>@<server-ip>
    mkdir -p ~/cloudzh && tar xzf ~/<file> -C ~/cloudzh --strip-components=1
    cd ~/cloudzh && sudo bash install.sh

    sudo demande le mot de passe de <user>.

  3. Répondre aux questions

    QuestionRéponse
    Domaine (laisser vide pour le mode LAN)Ton domaine, ou vide pour le mode LAN
    Sous-domaine du tableau de bordPar exemple app ; Entrée garde dash
    E-mail pour Let's EncryptTon adresse e-mail
    Jeton API CloudflareColle le jeton. Il reste invisible pendant la saisie ; l’installateur le vérifie auprès de Cloudflare.
    Dossier de données centralEntrée, pour /srv/data
    Clé de licence (CZL-…)Une clé de licence de ton e-mail ou de Mes licences. Chaque serveur a besoin de sa propre clé.

    Après l'installation, tu reçois un e-mail Confirmer le nouveau serveur. Vérifie que le code de vérification est le même que sur ton serveur et clique sur Oui, c'est moi ; le serveur s'active tout seul. Avec CloudZH Setup depuis ton compte client, il n'y a rien à confirmer.

    Le sous-domaine, l’e-mail et le jeton Cloudflare ne sont demandés qu’en mode domaine. Laisse la clé de licence vide pour activer plus tard avec sudo zh license activate CZL-… ; d’ici là, CloudZH fonctionne en mode restreint.

  4. Enregistrer la clé de sauvegarde

    À la fin, l’installateur affiche l’adresse du tableau de bord et un jeton de configuration. Copie 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

    /srv/data contenait déjà des médias ? Lance alors aussi sudo chown -R cloudzh:cloudzh /srv/data.

  5. Première connexion

    Ouvre l’adresse du tableau de bord : https://app.example.com avec un domaine, http://<server-ip> en mode LAN. Saisis le jeton de configuration et crée ton administrateur. Jeton perdu ? zh token l’affiche à nouveau.

  6. Vérifier

    Déconnecte-toi de SSH et reconnecte-toi une fois, puis :

    zh status
    zh doctor

    Mon compte → Abonnement dans le tableau de bord affiche la licence de ce serveur.