CLAUDE.md : ajout environnement à reproduire (zsh, oh-my-zsh, p10k, micro, tmux, nvm, outils CLI)

Permet à Claude Code sur le nouveau VPS de connaître et reproduire l'environnement de travail du serveur actuel. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Ajout CLAUDE.md : contexte et règles pour Claude Code sur le nouveau VPS
2026-09-11 01:26:41 +02:00 · 2026-09-11 00:47:29 +02:00
1 changed files with 175 additions and 0 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -0,0 +1,175 @@
+# 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.
+
+## Environnement à reproduire sur le nouveau VPS
+
+L'utilisateur a configuré cet environnement sur le serveur actuel (z-ana.com). Le reproduire sur le nouveau VPS après l'installation de HestiaCP.
+
+### Shell : Zsh + Oh My Zsh + Powerlevel10k
+
+```bash
+# Installer zsh
+sudo apt install -y zsh
+chsh -s /usr/bin/zsh
+
+# Oh My Zsh
+sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
+
+# Plugins
+git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
+git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
+
+# Thème Powerlevel10k
+git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/themes/powerlevel10k
+```
+
+Dans `~/.zshrc` :
+```
+ZSH_THEME="powerlevel10k/powerlevel10k"
+plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
+alias cls=clear
+```
+
+Puis lancer `p10k configure` pour configurer le prompt.
+
+### Éditeur : micro
+
+```bash
+sudo apt install -y micro
+sudo update-alternatives --install /usr/bin/editor editor /usr/bin/micro 60
+sudo update-alternatives --set editor /usr/bin/micro
+```
+
+Raccourcis micro (`~/.config/micro/bindings.json`) :
+```json
+{
+    "Alt-/": "lua:comment.comment",
+    "CtrlUnderscore": "lua:comment.comment"
+}
+```
+
+### Terminal multiplexeur : tmux
+
+```bash
+sudo apt install -y tmux
+```
+
+### Outils CLI à installer
+
+```bash
+sudo apt install -y \
+  curl wget git unzip zip rsync \
+  htop tmux screen jq ripgrep tree pv pigz zstd p7zip-full \
+  neofetch sysstat lsof strace socat whois tcpdump \
+  etckeeper debfoster dselect \
+  apt-file apt-listchanges apt-rdepends unattended-upgrades \
+  fail2ban monit \
+  python3 python3-venv \
+  ca-certificates gnupg lsb-release dnsutils
+```
+
+### Node.js via nvm
+
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
+# Relancer le shell, puis :
+nvm install --lts
+```
+
+Ajouter dans `~/.zshrc` :
+```
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+```
+
+### Claude Code
+
+```bash
+npm install -g @anthropic-ai/claude-code
+```
+
+### MOTD personnalisé
+
+Après installation de HestiaCP :
+- `/etc/update-motd.d/20-neofetch` : affiche neofetch à la connexion (config dans `/etc/neofetch.conf`)
+- `/etc/update-motd.d/30-updates` : script Python qui affiche les mises à jour disponibles (nécessite `python3-apt`)
+
+Les scripts se trouvent dans le guide chapitre 2 (`02-preparation-systeme.md`).
+
+### Swap et sysctl
+
+- Swap 4 Go, swappiness à 5 (chapitre 2 du guide)
+- `vm.swappiness = 5` dans `/etc/sysctl.d/99-swap.conf`
+
+### etckeeper + debfoster
+
+- etckeeper suit les modifications de `/etc` avec git
+- debfoster gère la liste des paquets voulus (`/etc/keepers`)
+- Script pre-commit `/etc/etckeeper/pre-commit.d/35debfoster` (chapitre 2 du guide)
+
+## 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.