Pourquoi self-héberger Coolify sur un VPS ?
Les PaaS managées sont confortables mais leur facturation grimpe vite et vos données vivent chez un tiers. Coolify renverse ce modèle : vous installez une PaaS complète sur votre VPS et ne payez que le serveur. Vous déployez par git push ou via une intégration GitHub/GitLab, Coolify détecte la stack (Nixpacks, Dockerfile, Docker Compose), build l'image, gère les certificats SSL, les variables d'environnement, les déploiements automatiques sur push, et même des bases de données managées. Un seul Coolify peut piloter plusieurs serveurs distants.
Ce que Coolify met à votre disposition
- Déploiement automatique sur
git pushdepuis GitHub, GitLab ou Gitea (webhooks intégrés) - Détection automatique de la stack via Nixpacks, ou build par Dockerfile / Docker Compose
- Certificats SSL Let's Encrypt générés et renouvelés sans configuration
- Bases de données en un clic : PostgreSQL, MySQL, MongoDB, Redis, avec sauvegardes planifiées
- Gestion centralisée des variables d'environnement, secrets et déploiements de preview
- Pilotage de plusieurs serveurs distants depuis une instance Coolify unique
Prérequis
Coolify orchestre Docker et héberge potentiellement vos applications et bases sur le même VPS : prévoyez au minimum 2 vCPU et 2 Go de RAM, mais 4 Go sont recommandés dès que vous y faites tourner plusieurs services. L'installation se fait sur un système fraîchement provisionné (Ubuntu/Debian) ; Coolify installe lui-même Docker. Il vous faut un domaine (ou sous-domaine) pour l'interface, et les ports 80, 443 et 8000 (panneau d'installation initial) ouverts.
Installer et déployer avec Coolify
Provisionner un VPS propre
Commandez un VPS Ubuntu 22.04 LTS dédié à Coolify. Mettez à jour le système et activez le pare-feu UFW en autorisant SSH (22), HTTP (80) et HTTPS (443). Évitez d'y installer manuellement Docker au préalable : le script d'installation s'en charge.
Lancer le script d'installation
Exécutez le script officiel : curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash. Il installe Docker, déploie la stack Coolify et démarre le tableau de bord. À la fin, accédez à http://votre-ip:8000 pour créer le compte administrateur initial.
Configurer le domaine du panneau
Dans les paramètres Coolify, renseignez le domaine de l'instance (coolify.votredomaine.com) après avoir pointé son enregistrement A vers le VPS. Coolify génère automatiquement le certificat SSL du panneau et bascule l'accès en HTTPS.
Connecter une source Git
Ajoutez une intégration GitHub/GitLab (App ou clé de déploiement). Coolify pourra ainsi cloner vos dépôts privés et créer des webhooks pour déployer automatiquement à chaque push sur la branche choisie.
Créer et déployer une application
Créez une nouvelle ressource, sélectionnez le dépôt et la branche. Coolify détecte la stack via Nixpacks ou utilise votre Dockerfile. Indiquez le domaine de l'application, ajoutez les variables d'environnement, puis lancez le déploiement : build, conteneur et certificat SSL sont gérés automatiquement.
Ajouter une base de données
Provisionnez un PostgreSQL ou Redis en un clic depuis l'interface. Coolify fournit la chaîne de connexion à injecter comme variable d'environnement de votre application, et vous propose des sauvegardes planifiées vers un stockage S3 compatible.
Sauvegardez régulièrement le répertoire de Coolify lui-même (/data/coolify) en plus de vos bases de données : il contient la configuration de toutes vos ressources. Et pour répartir la charge, n'hésitez pas à connecter des serveurs distants supplémentaires dans Coolify : vous gardez un panneau de contrôle unique tout en déployant les applications lourdes sur des VPS séparés.
La documentation officielle
Pour la configuration avancée et les options propres à l'outil, référez-vous à la documentation officielle de Coolify. Ce guide couvre la mise en ligne sur VPS ; la doc éditeur reste la référence pour les réglages fins, les mises à jour majeures et les cas d'usage spécifiques.
