Déployer vos applications avec Coolify sur un VPS

Un PaaS managé comme Heroku ou Render convient parfaitement pour un prototype ou un projet de taille modeste. Dès que vous hébergez plusieurs applications, ou que le trafic grossit, la facture monte en proportion — parfois au-delà du coût d'un VPS dédié. Coolify s'adresse à trois profils précis. Les agences web qui gèrent des dizaines de projets clients : un seul VPS Coolify remplace autant de comptes Heroku. Les indépendants qui souhaitent maîtriser leurs coûts d'infrastructure sans sacrifier la commodité du déploiement automatique. Les équipes qui ne peuvent pas confier leurs données à un tiers — RGPD, clients secteur public, données médicales ou financières. Dans les trois cas, Coolify reproduit le workflow PaaS (git push → déploiement) sur une infrastructure que vous contrôlez entièrement.

Coolify lui-même consomme peu de ressources, mais il orchestre Docker et héberge potentiellement vos applications et bases de données sur le même serveur. Prévoyez au minimum 2 vCPU et 2 Go de RAM pour Coolify seul. Dès que vous y faites tourner plusieurs services simultanément, 4 Go de RAM devient le plancher recommandé. L'espace disque dépend de vos applications : comptez 20 Go pour le système et Coolify, plus l'espace de vos images Docker et données.

Système d'exploitation : Ubuntu 22.04 LTS ou Debian 12 sur un serveur fraîchement provisionné. N'installez pas Docker manuellement au préalable — le script d'installation de Coolify gère cette étape et une version Docker pré-installée peut créer des conflits.

Ports à ouvrir dans votre pare-feu : 22 (SSH), 80 (HTTP), 443 (HTTPS) et 8000 (interface d'installation initiale de Coolify). Vous pouvez fermer le port 8000 après avoir configuré un domaine et basculé en HTTPS. Un nom de domaine ou sous-domaine est nécessaire pour l'interface Coolify et pour chaque application que vous déploierez.

Une fois la première application déployée, plusieurs réglages améliorent la fiabilité au quotidien.

Webhooks Git automatiques. L'intégration GitHub App ou GitLab OAuth crée les webhooks sur chaque dépôt au moment où vous configurez la ressource. Si vous utilisez une clé de déploiement SSH manuelle, créez le webhook côté Git en pointant vers https://coolify.votre-domaine.com/api/v1/deploy?uuid=<uuid-application>&secret=<secret>. L'UUID et le secret sont visibles dans l'onglet Webhooks de chaque ressource.

Variables d'environnement et secrets. Coolify distingue les variables visibles dans l'interface (variables d'environnement classiques) des secrets masqués (tokens, clés API). Les deux sont chiffrés en base. Vous pouvez définir des variables au niveau du projet — elles sont héritées par toutes les ressources — ou par ressource individuelle.

Monitoring intégré. L'onglet Métriques de chaque serveur affiche CPU, RAM et disque en temps réel. Vous pouvez configurer des notifications (email, Telegram, Slack, Discord, ntfy) pour les événements de déploiement, les erreurs et les alertes de ressources.

Mises à jour de Coolify. Les mises à jour se déclenchent depuis l'interface (Paramètres > Mettre à jour). Coolify tire la nouvelle version de ses images Docker, recrée ses propres conteneurs et redémarre. La mise à jour ne touche pas vos applications déployées.

Le build échoue avec No build method detected. Nixpacks n'a pas reconnu la stack. Ajoutez un fichier Dockerfile à la racine du dépôt ou sélectionnez manuellement la méthode de build dans les paramètres de l'application (Docker Compose si vous en avez un). Vous pouvez aussi forcer la stack Nixpacks en ajoutant un fichier nixpacks.toml à la racine.

Le domaine affiche 502 Bad Gateway après le déploiement. L'application n'écoute pas sur le port attendu par Traefik. Vérifiez le port d'exposition dans les paramètres de la ressource : il doit correspondre au port sur lequel votre application écoute à l'intérieur du conteneur. Pour une app Node.js qui démarre sur le port 3000, renseignez 3000 dans le champ « Port ».

Le certificat SSL ne se génère pas, l'accès reste en HTTP. Vérifiez que l'enregistrement DNS A pointe bien vers l'IP du VPS (propagation parfois longue). Vérifiez que le port 80 est ouvert dans UFW — Let's Encrypt en mode HTTP Challenge doit pouvoir joindre le serveur sur ce port. Si vous êtes derrière Cloudflare en mode proxy, passez en DNS Challenge.

L'application redémarre en boucle (Restarting). La commande de démarrage échoue. Consultez les logs du conteneur dans l'onglet Logs de la ressource. L'erreur est généralement une variable d'environnement manquante, une connexion à la base de données impossible (vérifiez la chaîne de connexion) ou un port déjà utilisé sur le serveur.

Ressources insuffisantes : le build est tué (Killed). La mémoire du VPS est insuffisante pendant le build. Deux options : ajouter de la mémoire swap temporairement (fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile) ou migrer vers un VPS avec plus de RAM. Pour les applications Node.js volumineuses, ajoutez NODE_OPTIONS=--max-old-space-size=4096 dans les variables d'environnement de build.

Coolify n'est pas le seul PaaS self-hosted disponible. CapRover, Dokploy et Dokku couvrent des besoins similaires, avec des philosophies différentes. Coolify se distingue par son interface moderne, la prise en charge native du multi-serveurs et le monitoring intégré — il est adapté aux équipes qui gèrent un parc de serveurs depuis un point de contrôle unique. CapRover est plus léger et adapté à un usage mono-serveur avec un seul administrateur. Dokploy est plus récent, orienté Docker Compose et Kubernetes avec une interface épurée. Pour une comparaison détaillée des trois plateformes sur les critères qui comptent (ressources, build, bases de données, accès collaboratif), consultez notre article comparatif.