Coolify (PaaS auto-hébergé)

1. Vue d’ensemble du concept et problématique système

Les plateformes PaaS cloud (Vercel, Heroku, Netlify, Render) ont offert aux développeurs un niveau de confort inégalé : un simple git push compile automatiquement le projet, attribue un domaine, configure SSL et déploie le service. Cependant, les entreprises paient ce confort au prix fort par une dépendance financière coûteuse et des contraintes architecturales strictes :

• Facturation prédatrice : Le coût du trafic dans le cloud dépasse de 10 à 20 fois les prix du marché, et les factures pour dépassement de quotas peuvent atteindre plusieurs milliers de dollars.
• Timeouts Serverless : La limite d’exécution des fonctions (15–60 secondes) rend impossible le lancement de cycles agentic autonomes, de scraping complexe ou de longues phases de réflexion des modèles linguistiques.
• Vendor lock-in : Les optimisations spécifiques compliquent la migration du code vers votre propre infrastructure.

Coolify propose le meilleur des deux mondes : l’expérience Vercel sur votre propre serveur pour 5 à 20 $ par mois. Il s’agit d’un système open-source de gestion de serveur (Self-Hosted PaaS), qui s’installe avec une seule commande, se connecte aux dépôts GitHub/GitLab et prend en charge tout le cycle de build, le routage du trafic et l’administration des bases de données.

2. Taxonomie architecturale et modèle mental

L’ossature architecturale de Coolify repose sur l’orchestration du démon Docker et un proxy dynamique :

┌─────────────────────────────────────────────────────────────┐
│                    ARCHITECTURE HÔTE COOLIFY                │
├─────────────────────────────────────────────────────────────┤
│ 1. Proxy Inverse Dynamique (Moteur Central Traefik v3)      │
│    • Routage automatique des ports via les Labels Docker    │
│    • Certificats SSL automatiques Let's Encrypt (ACME)      │
├─────────────────────────────────────────────────────────────┤
│ 2. Plan de Contrôle Coolify (API Laravel & Interface Web)   │
│    • Gestionnaire de webhooks GitHub / GitLab               │
│    • Gestion des variables d'environnement (.env chiffré)   │
├─────────────────────────────────────────────────────────────┤
│ 3. Moteur de Build Polyglotte :                             │
│    • Nixpacks (Détection auto des langages : Node, Bun,     │
│      Python, Go)                                            │
│    • Constructeur Dockerfile / Docker Compose               │
├─────────────────────────────────────────────────────────────┤
│ 4. Datastores & Stockage Gérés (Postgres, Redis, Backup S3) │
└─────────────────────────────────────────────────────────────┘

1. Proxy inverse dynamique (Moteur Traefik) :
   • Gestionnaire central du trafic entrant. Il écoute en permanence le socket Docker : lorsqu’un nouveau conteneur est lancé avec des étiquettes de domaine, Traefik le détecte instantanément, émet un certificat SSL et commence à router les requêtes HTTP/HTTPS sans redémarrage du proxy.
2. Moteur de build universel (Nixpacks & Docker) :
   • Permet la compilation du code sans nécessiter l’écriture manuelle de Dockerfile complexes. Nixpacks reconnaît automatiquement la version de Node.js, installe les dépendances via pnpm et génère un conteneur minimaliste.
3. Gestion des données en un clic (Managed Databases) :
   • Déploiement d’instances PostgreSQL, Redis, MySQL, ClickHouse ou MinIO prêtes pour la production, avec sauvegarde chiffrée automatique vers un stockage S3 cloud (AWS ou Cloudflare R2) selon une planification définie.
4. Isolation des environnements (Preview Deployments) :
   • Lancement automatique de copies éphémères distinctes du service pour chaque Pull Request ouverte, sur des sous-domaines temporaires.

3. Pipeline technique et mécanique interne

Le cycle de vie du déploiement continu (GitOps Lifecycle) dans Coolify :

1. Validation du code et Webhook : L’ingénieur effectue un git push origin main. GitHub envoie un webhook signé HMAC à l’API de Coolify.
2. Validation et lancement du worker : Coolify vérifie la signature de sécurité, récupère le commit frais basé sur le SHA-hash spécifié et lance un conteneur de build isolé.
3. Phase de compilation (Build Nixpacks) : Installation des dépendances, exécution de la compilation de l’application (npm run build). Création d’une image Docker optimisée pour la production.
4. Bascule fluide du trafic (Rolling Deployment) :
   • Un nouveau conteneur applicatif est lancé sur un nouveau port interne.
   • Traefik vérifie l’état de santé (Health Check).
   • Dès que le nouveau conteneur répond HTTP 200, le proxy bascule le trafic, et l’ancien conteneur est arrêté (Zero-Downtime Swap).
5. Alerting et notifications : Le statut du déploiement réussi est envoyé à l’ingénieur via Telegram ou Discord, avec un lien vers le commit.

4. Scénarios d’ingénierie pratiques en production

01. Déploiement d’une plateforme Full-Stack Next.js 15 sur un serveur à 10 $

Lancement complet d’un SaaS commercial sur un VPS chez Hetzner :

• Coolify compile le frontend Next.js, déploie la base PostgreSQL et Redis pour la mise en cache des sessions.
• Le trafic passe par le Traefik intégré avec support HTTP/2 et SSL.
• Le service supporte un million de vues mensuelles avec zéro coût supplémentaire lié au cloud.

02. Hébergement d’agents AI longue durée sans timeouts

Déploiement de processus backend complexes (LangGraph, auto-scraping) :

• Sur Vercel, la requête est interrompue après 60 secondes.
• Avec Coolify, l’agent peut fonctionner de manière autonome pendant 4 heures consécutives dans un conteneur en arrière-plan, maintenant des connexions WebSocket ouvertes avec le client.

03. Création d’environnements de prévisualisation temporaires (PR Previews)

Organisation d’une revue confortable pour l’équipe :

• À l’ouverture de la PR #87, Coolify déploie automatiquement l’application à l’adresse pr-87.gotburnout.dev.
• Le testeur vérifie les fonctionnalités en direct avant la fusion dans la branche principale, après quoi le conteneur est automatiquement supprimé à la fermeture de la PR.

5. Pièges courants, erreurs typiques et sécurité

• Crash du serveur dû à un manque de mémoire (Build OOM) : La compilation de projets frontend modernes sur Next.js peut consommer jusqu’à 3–4 Go de RAM lors de l’optimisation des bundles. Sur les serveurs disposant de 2 Go de RAM, il est impératif de créer un fichier de swap (swapfile) d’au moins 4 Go.
• Exposition du panneau de contrôle aux scanners : Par défaut, l’interface de Coolify fonctionne sur le port 8000. Vous devez impérativement la protéger avec votre propre domaine et une authentification à deux facteurs (2FA) obligatoire, ou la fermer via le pare-feu UFW en autorisant le trafic uniquement via Tailscale/VPN.
• Saturation de l’espace disque par les anciennes images Docker : Chaque déploiement quotidien génère des dizaines de couches compilées. Si vous n’activez pas le nettoyage automatique (Docker Cleanup Scheduler), le disque sera saturé en quelques semaines.
• Stockage des mots de passe de base de données dans des fichiers non sécurisés : Utilisez le gestionnaire de secrets intégré de Coolify pour injecter les variables d’environnement plutôt que de committer des fichiers .env dans le dépôt.