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 et version : apt (Debian/Ubuntu) ou dnf (RHEL/Fedora/Rocky/Alma) ?
2. 02reconDocker Engine + plugin compose présents et service actif ? (podman-docker ou Docker snap : à signaler, ne pas mélanger)
3. 03reconimmich déjà déployé (conteneur, volumes, /opt/immich) ? sain → vérifier et passer ; ne jamais écraser ni supprimer
4. 04reconport 2283 (ou celui de la variable port) déjà pris, et par quoi ? vide = libre ; pris → demande un autre port (ask_user)
5. 05reconRAM, CPU et disque libres : Immich veut ≥ 4 Go de RAM (6 recommandés), 2 cœurs, et du disque pour les photos
6. 06recon/opt sur disque local ? (la base Postgres ne supporte pas les partages réseau)
7. 07reconseulement si un domaine est fourni : un reverse proxy occupe-t-il déjà 80/443 ? (le réutiliser plutôt qu’en installer un second)
8. 08reconun pare-feu (ufw ou firewalld) est-il actif ?
9. 09agirInstaller Docker Engine + Compose (seulement si absent)vérif
10. 10agirTélécharger le compose et le .env officielsvérif
11. 11agirConfigurer le .env (chemins, fuseau, mot de passe DB généré)vérif
12. 12agirRestreindre le port web à 127.0.0.1vérif
13. 13agirDémarrer la stackvérif
14. 14agirRépond en HTTPvérif
15. 15agirInstaller Caddy (seulement si un domaine est fourni et aucun reverse proxy)vérif
16. 16agirReverse proxy HTTPS (seulement si un domaine est fourni)vérif
17. 17agirOuvrir 80/443 (seulement si un domaine est fourni et un pare-feu actif)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 si absent)Vérifié pardocker compose version && systemctl is-active dockerattendu : Docker Compose version v2… puis active
2. 02vérifTélécharger le compose et le .env officielsVérifié pargrep -c "immich-server" /opt/immich/docker-compose.yml && grep "^IMMICH_VERSION=" /opt/immich/.envattendu : au moins 1 puis IMMICH_VERSION=v…
3. 03vérifConfigurer le .env (chemins, fuseau, mot de passe DB généré)Vérifié pargrep -E "^(UPLOAD_LOCATION|DB_DATA_LOCATION|TZ)=" /opt/immich/.env; grep -c "^DB_PASSWORD=postgres$" /opt/immich/.envattendu : les 3 valeurs, puis 0 (mot de passe par défaut remplacé)
4. 04vérifRestreindre le port web à 127.0.0.1Vérifié pargrep -c "127.0.0.1:${port}:2283" /opt/immich/docker-compose.ymlattendu : 1
5. 05vérifDémarrer la stackVérifié pardocker inspect -f '{{.State.Status}}' immich_serverattendu : running
6. 06vérifRépond en HTTPVérifié parcurl -s -o /dev/null -w '%{http_code}' --retry 40 --retry-delay 5 --retry-connrefused http://127.0.0.1:${port}/api/server/pingattendu : 200
7. 07vérifInstaller Caddy (seulement si un domaine est fourni et aucun reverse proxy)Vérifié parcaddy version && systemctl is-active caddyattendu : v2.… puis active
8. 08vérifReverse proxy HTTPS (seulement si un domaine est fourni)Vérifié parcurl -s -o /dev/null -w '%{http_code}' --retry 6 --retry-delay 5 https://${domain}/attendu : 200, 301 ou 302 (certificat obtenu)
9. 09vérifOuvrir 80/443 (seulement si un domaine est fourni et un pare-feu actif)Vérifié parufw status 2>/dev/null | grep ALLOW; firewall-cmd --list-ports 2>/dev/null; trueattendu : 80/tcp, 443/tcp autorisés, ou aucun pare-feu actif

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 Immich 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 auto-hébergé

1. 01VaultwardenGestionnaire de mots de passe Vaultwarden (compatible Bitwarden) via Docker Compose, en HTTPS si un domaine est fourni.
2. 02GiteaForge Git légère Gitea via Docker Compose (SQLite), web en local, SSH Git sur un port dédié.
3. 03Uptime KumaMonitoring d’uptime Uptime Kuma 2 via Docker Compose, en HTTPS si un domaine est fourni.
4. 04NextcloudNextcloud (cloud de fichiers) via Docker Compose : PostgreSQL, Redis, cron, admin créé automatiquement.
5. 05JellyfinServeur média Jellyfin via Docker Compose, dossier média monté en lecture seule, HTTPS si un domaine est fourni.