vps-docs/CLAUDE.md

Instructions pour Claude Code

Ce dépôt contient le guide d'installation VPS avec HestiaCP et la documentation de l'ancien serveur ISPConfig. Claude Code est utilisé pour assister l'utilisateur étape par étape dans la configuration du serveur.

Utilisateur

• Langue : français. Les fichiers techniques (code, configs) restent en anglais.
• Approche : avancer commande par commande, pas tout d'un coup. Expliquer chaque étape avant de l'exécuter.
• Éditeur : micro (/usr/bin/micro). Ne jamais demander d'ouvrir nano, vim ou un autre éditeur.
• Username serveur : scriptshadow

Modifications système avec sudo

Règle obligatoire quand une commande sudo est refusée ou pour toute modification de fichier système :

1. Écrire un script Python autonome dans ~/setup_xxx.py contenant toutes les modifications.
2. Proposer la commande combinée : sudo python3 ~/setup_xxx.py && rm ~/setup_xxx.py

Le script doit être autonome : imports, chemins absolus, vérifications. La suppression se fait dans la même commande.

Exception : si sudo -n fonctionne dans la session (NOPASSWD configuré), on peut exécuter directement.

Ne jamais demander à l'utilisateur d'ouvrir un éditeur pour modifier un fichier système.

Guide HestiaCP

Le guide complet est dans hestiacp/ :

• hestiacp/chapitres/*.md : 14 chapitres + annexe, variables {{IP}}, {{DOMAINE}}…
• hestiacp/skglobalinstitute.conf : variables du VPS en cours d'installation
• hestiacp/build/build.py : générateur PDF (WeasyPrint)
• Commandes vérifiées contre HestiaCP 1.10.4 (code source GitHub, en-têtes # options: des scripts bin/v-*)

Pour suivre le guide : ouvrir le chapitre correspondant, exécuter les commandes une par une en remplaçant les {{VARIABLES}} par les valeurs de skglobalinstitute.conf.

VPS en cours : skglobalinstitute.com

• Domaine : skglobalinstitute.com (registrar OVH)
• Hébergeur : Contabo Cloud VPS 6 — 6 cœurs, 12 Go RAM, 200 Go disque
• IPv4 : 144.91.70.25
• IPv6 : 2a02:c207:2356:8609::1
• Hostname : srv1.skglobalinstitute.com
• Admin panel : skadmin
• Utilisateur hébergement : skglobal
• Utilisateur système (sudo) : scriptshadow
• Email admin : issazana.ia@gmail.com
• Port SSH : 50022
• Port panel : 8083
• Sauvegarde distante : node21-eu.n0c.com (user qmwwranm, port 5022)

Pièges HestiaCP à connaître

Ces points ont été vérifiés dans le code source de HestiaCP 1.10.4 :

• Pare-feu IPv4 seulement : le pare-feu HestiaCP ne filtre pas l'IPv6. Le panel écoute sur [::]:8083. Il faut un pare-feu ip6tables séparé (chapitre 4).
• Pas d'enregistrement AAAA : HestiaCP sert web et mail en IPv4 seulement. Un AAAA ferait échouer Let's Encrypt.
• sudo ne trouve pas les commandes v-* : il faut ajouter /usr/local/hestia/bin au secure_path dans /etc/sudoers.d/.
• Groupe admin préexistant : l'image Contabo Ubuntu 24.04 a déjà un groupe admin et UFW installé. L'installeur HestiaCP refuse les deux.
• Port SSH : le changer après l'installation, pas avant. Sur Ubuntu 24.04, SSH utilise ssh.socket (pas ssh.service).
• Document root Symfony : v-change-web-domain-docroot USER DOM DOM public yes — le yes est indispensable, sinon open_basedir exclut vendor/, var/, config/.
• Zone DNS avant domaine mail : DKIM n'est ajouté au DNS que si la zone existe déjà. Créer la zone DNS d'abord.
• Changement de template DNS : v-change-dns-domain-tpl efface tous les enregistrements ajoutés à la main. Ne le faire qu'immédiatement après la création de la zone.

Serveur ISPConfig existant (z-ana.com)

L'ancien serveur (62.169.29.111) utilise ISPConfig et héberge z-ana.com, stlab.ci, djeliba.ci, santeverte.ci, tchefon.ci. La documentation de sa configuration est dans les fichiers 01-prerequis.md à 16-notes-pieges.md à la racine du dépôt.

Le nouveau VPS (skglobalinstitute.com) est un serveur séparé avec HestiaCP. Ne pas confondre les deux.