SEC.01

Le playbook

Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.

1. 01recondistro, version et gestionnaire de paquets (apt ou dnf)
2. 02reconDocker Engine + plugin compose présents et actifs ? (sinon, étape docker)
3. 03reconconteneurs et ports déjà utilisés (conflit de nom ou de port avec la stack ?)
4. 04reconune stack existe-t-elle déjà dans ce dossier ? ne pas écraser son compose
5. 05reconun reverse proxy (nginx, caddy, traefik) occupe-t-il déjà 80/443 ?
6. 06reconRAM et disque libres pour les images de la stack
7. 07agirInstaller Docker Engine + Compose (seulement s’il est absent)vérif
8. 08agirPlacer le compose dans /opt/<nom> (le demander s’il n’est pas fourni)vérif
9. 09agirLancer la stackvérif
10. 10agirReverse proxy HTTPS (seulement si un domaine est fourni)vérif

SEC.02

Ce qu'elle vérifie

Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.

1. 01vérifInstaller Docker Engine + Compose (seulement s’il est absent)Vérifié parsystemctl is-active docker && docker compose versionattendu : active, puis « Docker Compose version v2… »
2. 02vérifPlacer le compose dans /opt/<nom> (le demander s’il n’est pas fourni)Vérifié pardocker compose -f /opt/${app_name}/compose.yaml config -q && echo okattendu : ok (compose valide)
3. 03vérifLancer la stackVérifié pardocker compose -f /opt/${app_name}/compose.yaml ps --status running --format "{{.Name}}"attendu : tous les services du compose listés comme running
4. 04vérifReverse proxy HTTPS (seulement si un domaine est fourni)Vérifié parcurl -s -o /dev/null -w '%{http_code}' https://${domain}/attendu : 200, 301 ou 302 (certificat TLS émis)

SEC.03

Les garde-fous

Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.

SEC.04

Les variables

Ce que vous choisissez avant de lancer — la recette s'occupe du reste.

SEC.05

Comment une recette s'exécute dans Servor

Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.

SEC.06

Bouton Deploy on Servor

Vous maintenez Déployer une app Docker Compose ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.

SEC.07

D'autres recettes web & cms

1. 01WordPressWordPress via Docker Compose (app + MariaDB, secrets générés), HTTPS si un domaine est fourni.
2. 02GhostPlateforme de blog Ghost 6 via Docker Compose (Ghost + MySQL), servie en HTTPS.
3. 03OdooERP Odoo 20 Community via Docker Compose (Odoo + Postgres), master password généré, HTTPS si un domaine est fourni.
4. 04DiscourseForum Discourse (installation officielle discourse_docker, HTTPS Let’s Encrypt). Prend les ports 80/443.
5. 05MattermostMessagerie d’équipe Mattermost via Docker Compose (Mattermost + Postgres), HTTPS si un domaine est fourni.