# Annexe : adresses et régénération du guide

## Récapitulatif des adresses

| Service | Adresse |
|---|---|
| Panel HestiaCP | `https://{{FQDN}}:{{PANEL_PORT}}` |
| SSH administrateur | `ssh -p {{SSH_PORT}} {{USER}}@{{IP}}` |
| SSH déploiement | `ssh -p {{SSH_PORT}} {{CLIENT}}@{{IP}}` |
| Webmail | `https://webmail.{{DOMAINE}}` |
| Mail (IMAP / SMTP) | `mail.{{DOMAINE}}` : 993 / 465 ou 587 |
| phpMyAdmin | `https://{{FQDN}}/<alias-du-chapitre-4>/` |
| Portainer | `https://portainer.{{DOMAINE}}` |
| Uptime Kuma | `https://status.{{DOMAINE}}` |
| Netdata | tunnel SSH puis `http://localhost:19999` |
| Serveurs DNS | `ns1.{{DOMAINE}}`, `ns2.{{DOMAINE}}` → {{IP}} |

## Générer ce guide pour un autre VPS

Ce PDF est produit à partir de fichiers Markdown, qui se trouvent dans le dépôt `vps-docs`, dossier `hestiacp/` :

| Élément | Rôle |
|---|---|
| `chapitres/*.md` | Le contenu, un fichier par chapitre ; `{{…}}` marque une variable |
| `vps.conf.exemple` | Modèle de fichier de variables |
| `build/build.py` | Le générateur (Markdown → HTML → PDF avec WeasyPrint) |
| `build/style.css`, `build/fonts/` | La mise en page et les polices |
| `build/meta.conf` | Version de HestiaCP et date de vérification affichées en couverture |

Installez une fois les outils (Ubuntu ou Debian) :

```bash
sudo apt install -y python3-venv libpango-1.0-0 libpangoft2-1.0-0
python3 -m venv ~/.venvs/guide
~/.venvs/guide/bin/pip install weasyprint markdown pygments
```

Puis, pour un nouveau VPS :

```bash
cd vps-docs/hestiacp
cp vps.conf.exemple nouveau-vps.conf
micro nouveau-vps.conf
~/.venvs/guide/bin/python build/build.py --vars nouveau-vps.conf
```

Le fichier `Guide-VPS-HestiaCP-<FQDN>.pdf` est créé, avec toutes les valeurs déjà remplies. Sans `--vars`, vous obtenez la version générique.

> [!WARNING] Avant chaque nouvelle installation
> HestiaCP évolue vite. Avant d'installer un nouveau serveur :
> - consultez les notes de version sur <https://github.com/hestiacp/hestiacp/releases> ;
> - vérifiez les options de l'installeur avec `bash hst-install.sh -h` ;
> - en cas de doute sur une commande `v-…`, lisez son en-tête : `head -12 /usr/local/hestia/bin/<commande>` ;
> - mettez à jour `build/meta.conf` après vérification.

## Sources officielles

- Documentation HestiaCP : <https://hestiacp.com/docs/>
- Code source et scripts `v-*` : <https://github.com/hestiacp/hestiacp>
- Forum : <https://forum.hestiacp.com>
- Installation de Docker : <https://docs.docker.com/engine/install/ubuntu/>