Coolify v4.3 sur VPS : pilotez vos apps sans PaaS managé

Heroku facture par dyno, Railway par heure de compute et par Go de bande passante sortante, Render par service actif. Dès qu'un projet client sort du plan gratuit — ou que le plan gratuit disparaît, comme Heroku l'a fait en novembre 2022 — la facture monte par paliers. Pour une agence qui gère huit à quinze applications, le cumul dépasse rapidement ce qu'un VPS dédié à l'orchestration coûterait sur l'année. La problématique n'est pas le prix d'un projet isolé : c'est la multiplication des lignes de facturation, chacune sur un cycle différent, avec des règles de dépassement propres à chaque plateforme. S'y ajoute le vendor lock-in : les variables d'environnement, les add-ons de base de données et les pipelines de déploiement sont des constructions propriétaires qu'il faudra migrer si la plateforme modifie ses tarifs ou sa politique de rétention. Coolify supprime ces lignes en les remplaçant par une seule : le VPS qui héberge l'orchestrateur.

Coolify orchestre Docker et peut faire tourner simultanément vos applications, vos bases de données et son propre panneau sur le même serveur. Les ressources minimales pour démarrer sont 2 vCPU et 2 Go de RAM — suffisant pour une poignée de services légers. En production, avec plusieurs projets clients actifs, prévoyez 4 Go de RAM : chaque container réserve sa mémoire, et les bases de données (PostgreSQL, Redis, MySQL) consomment de manière constante. Le stockage dépend de vos volumes : comptez au moins 40 Go SSD, davantage si vous activez les backups locaux. Les ports TCP 80 et 443 doivent être ouverts pour Let's Encrypt et le trafic applicatif. Le port 22 (SSH) est requis pour l'installation et l'administration. Coolify n'est pas compatible avec un VPS sur lequel Docker a déjà été installé manuellement avec une configuration non standard : partez d'une image Ubuntu 22.04 LTS fraîche ou Debian 12.

Coolify surveille la branche que vous avez désignée et déclenche un nouveau déploiement à chaque push via webhook. Le cycle complet — réception de l'événement GitHub/GitLab, build de l'image, arrêt du container précédent, démarrage du nouveau — prend généralement moins d'une minute pour une application Node.js standard. Les variables d'environnement sont gérées par secret chiffré dans la base de données de Coolify : elles ne transitent jamais en clair dans les logs. Pour une application qui nécessite une base de données, créez d'abord le service de base de données dans le même projet Coolify (New Resource > Database), notez les identifiants générés, puis ajoutez-les comme variables d'environnement dans l'application. Les deux services partagent automatiquement le même réseau Docker interne.

Les deploy previews s'activent depuis la page de configuration de l'application, dans l'onglet Preview Deployments. Une fois activé, chaque pull request ouverte sur le dépôt reçoit automatiquement un environnement éphémère accessible par une URL construite sur le modèle <pr-number>.<domaine-app>. Coolify gère le certificat SSL de cet environnement via Let's Encrypt et détruit l'environnement à la fermeture ou au merge de la PR. Pour les backups de volumes, rendez-vous dans Storage > Backups au niveau du service concerné. Renseignez les identifiants d'un bucket compatible S3 (AWS S3, Cloudflare R2, MinIO auto-hébergé), la fréquence souhaitée (quotidienne, hebdomadaire) et la rétention en nombre de copies. Coolify crée une archive compressée du volume et la transfère vers le bucket selon le planning défini. Vérifiez la première exécution manuellement depuis le tableau de bord pour confirmer que les identifiants S3 fonctionnent avant de vous reposer sur l'automatisation.

Quatre situations reviennent régulièrement lors des premières installations ou après une mise à jour.

Port 80 ou 443 déjà occupé. Coolify utilise Traefik comme reverse proxy sur les ports 80 et 443. Si un autre processus occupe ces ports (nginx, Apache installé directement sur le VPS), Traefik ne démarre pas et aucun certificat ne peut être émis. Vérifiez avec ss -tlnp | grep -E ':80|:443', arrêtez le processus concurrent, puis redémarrez Coolify avec docker compose -f /data/coolify/source/docker-compose.yml restart.

Webhook Git non déclenché après un push. La cause la plus fréquente est un pare-feu réseau qui bloque les adresses IP sortantes de GitHub ou GitLab vers votre VPS. Vérifiez que les plages IP de GitHub Webhooks (https://api.github.com/meta) sont autorisées sur le port 443 de votre VPS. Vérifiez également dans Coolify que le webhook a bien été créé dans les paramètres du dépôt GitHub (onglet Webhooks du dépôt).

Certificat SSL bloqué en attente. Let's Encrypt utilise le challenge HTTP-01 : il tente de joindre http://<votre-domaine>/.well-known/acme-challenge/. Si le DNS du domaine n'est pas encore propagé, ou si le port 80 n'est pas accessible depuis l'extérieur, le challenge échoue et Traefik retente toutes les cinq minutes. Attendez la propagation DNS complète, vérifiez l'accessibilité du port 80 avec curl -I http://<votre-domaine>, puis relancez le service applicatif dans Coolify.

Application démarrée mais inaccessible. Vérifiez que le port exposé dans la configuration Coolify correspond au port sur lequel votre application écoute réellement à l'intérieur du container. Un container Node.js qui écoute sur 3000 doit avoir 3000 comme port de container dans la configuration Coolify, même si l'URL publique utilise le port 443.

Coolify s'intègre dans un écosystème de solutions de déploiement auto-hébergées. Si votre contexte exige une approche différente — pipeline GitOps via Kamal, orchestration légère avec Dokploy, ou interface simplifiée avec Easypanel — chaque outil a ses forces selon la taille de l'équipe et la complexité des déploiements. Les articles associés explorent ces alternatives et les cas d'usage spécifiques à chaque environnement.