# Guide VPS HestiaCP (PDF réutilisable)

Guide pas à pas pour installer un serveur d'hébergement complet avec **HestiaCP** sur un VPS Ubuntu 24.04 : web, DNS, mail, SSL, sécurité, Docker, supervision et sauvegardes.

Commandes vérifiées le 10 septembre 2026 pour **HestiaCP 1.10.4**, contre le code source officiel (en-têtes `# options:` des scripts `bin/v-*`).

## Fichiers

| Fichier | Rôle |
|---|---|
| `Guide-VPS-HestiaCP.pdf` | Version générique, avec les variables `<IP>`, `<DOMAINE>`… |
| `Guide-VPS-HestiaCP-<FQDN>.pdf` | Version personnalisée pour un VPS donné |
| `chapitres/*.md` | Contenu (un fichier par chapitre, variables `{{IP}}`…) |
| `vps.conf.exemple` | Modèle de fichier de variables |
| `skglobalinstitute.conf` | Variables du VPS skglobalinstitute.com |
| `build/` | Générateur (`build.py`), style, polices, `meta.conf` |

## Générer le PDF

```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

~/.venvs/guide/bin/python build/build.py                       # générique
~/.venvs/guide/bin/python build/build.py --vars mon-vps.conf   # personnalisé
```

## Syntaxe des chapitres

- `# Titre` : un chapitre ; `## Titre` : une étape numérotée avec case à cocher.
- `{{VARIABLE}}` : une variable (liste dans `build/build.py`, `VARIABLES`).
- Encadrés : `> [!NOTE]`, `> [!TIP]`, `> [!WARNING]`, `> [!DANGER]`, `> [!CHECK]`, avec un titre optionnel après le type.
- Un fichier dont le nom commence par `99` est affiché comme annexe.