Guide

Coolify, ton propre PaaS sur ton propre serveur

Coolify est une plateforme de déploiement auto-hébergée : Docker, certificats TLS, bases de données et previews sur ton serveur. Tarifs, ports et pièges.

L'équipe CodeWorlds18 min de lecture ·

Pratique HTML et CSS dans des leçons interactives avec un éditeur de code.

Crée un compte gratuit→
Dans cet article9

Coolify est une plateforme de déploiement auto-hébergée : tu l'installes sur ton propre serveur et tu obtiens des déploiements directement depuis un dépôt, des bases de données, des certificats TLS et des environnements de preview. Le dépôt coollabsio/coolify compte environ 60,8 mille étoiles et une licence Apache 2.0, et la version stable actuelle porte le numéro 4.3.9, datée du 18 août 2026.

Ce que Coolify fait sur ton serveur

Après l'installation, tu obtiens un panneau web qui gère Docker sur une machine ou sur plusieurs à la fois. Tu le pointes vers un dépôt, Coolify construit une image à partir de celui-ci, démarre un conteneur et le branche sur un reverse proxy qui émet lui-même le certificat. C'est tout le mécanisme, sans magie, mais avec beaucoup de colle que tu n'as plus à écrire toi-même.

La couche de build repose sur des build packs. Tu as le choix entre Nixpacks, qui détecte tout seul la technologie du projet, un mode statique servi par Nginx, ton propre Dockerfile, Docker Compose pour les applications à plusieurs composants, et une image prête à l'emploi issue d'un registre. La source du code peut être un dépôt public, un dépôt privé connecté via une GitHub App, ou un dépôt connecté via une deploy key.

Le trafic est géré par Traefik ou Caddy, au choix. Les certificats sont émis automatiquement, à condition que le port 80 soit ouvert, car la vérification du domaine passe par lui. Pour chaque application, tu déclares les ports à exposer, et le premier d'entre eux devient le port par défaut des health checks du conteneur.

Au-delà des applications, Coolify exécute des bases de données et des services prêts à l'emploi. La prise en charge couvre PostgreSQL, MySQL, MariaDB, MongoDB, Redis et plusieurs autres moteurs, tandis que le catalogue de services en un clic compte plus de 280 entrées d'après la description du dépôt. Chacun d'eux n'est qu'un fichier Compose préparé que tu peux ensuite remplacer par le tien.

Ce que Coolify ne fait pas doit aussi être dit clairement. Il n'y a pas de réseau de diffusion de contenu, pas de fonctions edge, pas de mise à l'échelle horizontale qui démarre toute seule sous charge. Il n'y a pas non plus de réponse au fait que ton serveur est situé à un seul endroit de la planète. Si tu as besoin de contenu proche des utilisateurs dans une douzaine de régions, Coolify ne le remplacera pas, et placer Cloudflare devant a plus de sens.

Version, licence et santé du projet

Le projet existe depuis janvier 2021 et avance vite. Le dépôt compte 5 318 forks et 670 issues ouvertes, n'est pas archivé, et la dernière modification sur la branche principale date du 20 août 2026. Derrière tout cela se trouve la société hongroise coolLabs Solutions Kft.

Le numéro de version comporte un petit piège qui mérite attention quand on fige une image. Le fichier versions.json de la branche principale indique 4.3.10 pour le canal v4, alors que la version stable publiée la plus récente est la 4.3.9. De plus, la 4.4-rc.1 existe et est marquée comme préversion. Le numéro de la branche principale devance donc ce qui a réellement été livré, et si tu construis une automatisation autour de ce fichier, vérifie les deux sources.

Bash
# what counts as the current version: main branch versus published release
curl -s https://raw.githubusercontent.com/coollabsio/coolify/main/versions.json

curl -s https://api.github.com/repos/coollabsio/coolify/releases/latest \
  | grep '"tag_name"'

La licence est simple, ce qui est rare dans cette catégorie d'outils. La racine du dépôt contient un seul fichier LICENSE avec le texte complet de l'Apache License 2.0, l'interface de programmation de GitHub indique apache-2.0, et il n'existe pas de répertoire séparé contenant du code destiné aux clients commerciaux. Il n'y a pas non plus de paquet complémentaire dont l'installation apporterait une licence propriétaire. Tout ce que tu vois dans la variante payante vit dans ce même open source.

Cette uniformité a une conséquence pratique : la variante auto-hébergée n'est pas une édition amputée. L'éditeur ne garde rien derrière une barrière de licence, donc tu n'as pas à vérifier à chaque version si la fonctionnalité sur laquelle tu comptes est passée dans un répertoire payant.

Le risque se situe ailleurs. Le projet repose sur un mainteneur dominant et une société de taille modeste, tandis que la numérotation des versions avance plusieurs fois par semaine. Une mise à jour peut changer le comportement du proxy ou la façon dont les fichiers Compose sont générés, et tu le découvriras sur ta propre installation plutôt que sur l'environnement de staging de l'éditeur.

Prérequis serveur, installation et ports

Le minimum matériel indiqué dans la documentation est de deux cœurs de processeur, 2 Go de mémoire et 30 Go d'espace libre. L'éditeur note que Coolify démarrera probablement avec moins, mais recommande de la marge, car tes applications et tes processus de build partagent cette même mémoire. L'architecture doit être 64 bits, soit amd64 soit arm64.

La liste des systèmes pris en charge est large : les distributions basées sur Debian, celles basées sur Red Hat, celles basées sur SUSE, Arch Linux, Alpine Linux et Raspberry Pi OS 64 bits. Le script d'installation ne gère automatiquement que les éditions à support long d'Ubuntu, c'est-à-dire 20.04, 22.04 et 24.04. Sur Ubuntu hors de cette liste, 24.10 par exemple, l'installation manuelle reste la seule option. Sur certaines distributions, AlmaLinux étant celle citée, Docker doit être installé au préalable. Le moteur Docker requis est en version 24 ou supérieure.

Bash
# minimum: 2 cores, 2 GB RAM, 30 GB free space, amd64 or arm64
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

# ports required when reaching the panel by the server's IP address
# 8000 panel, 6001 real-time communication, 6002 terminal
# 22 SSH, 80 certificate issuance, 443 HTTPS traffic

# the public key must land on root on every managed server
cat ~/.ssh/coolify.pub >> /root/.ssh/authorized_keys

Le port 6002 sert le terminal intégré au panneau et est requis depuis la version 4.0.0-beta.336. Une fois que ton propre domaine pointe vers le panneau, les ports 8000, 6001 et 6002 peuvent être fermés, car le trafic passera par le proxy sur 443. Il reste alors 22, 80 et 443.

Fermer des ports comporte un piège qui surprend les habitués des serveurs ordinaires. Docker écrit ses propres règles iptables basées sur la traduction d'adresses et peut contourner UFW, donc un blocage écrit dans UFW ne se comportera pas comme tu l'attends. La documentation recommande un pare-feu côté fournisseur cloud, et là où le fournisseur n'en propose aucun, l'outil ufw-docker maintenu par la communauté.

La connexion à chaque serveur géré passe par SSH avec authentification par clé, et la clé publique doit se retrouver dans le fichier authorized_keys de l'utilisateur root. Coolify peut générer une paire de clés depuis le panneau. Tu peux aussi garder l'instance et les applications sur une seule machine, mais la documentation le déconseille, car la charge de build peut faire tomber le panneau au moment où tu en as le plus besoin.

Avec plusieurs serveurs, il faut comprendre une chose pour ne pas perdre des heures en diagnostic DNS. Chaque serveur connecté exécute son propre proxy et gère le trafic de ses propres applications. Le serveur principal ne fournit que le panneau, établit les connexions SSH et effectue les health checks, et ne transmet aucun trafic. Tu pointes donc le domaine vers l'adresse du serveur sur lequel l'application tourne, pas vers l'instance Coolify.

Déploiements depuis un dépôt, variables et environnements de preview

Déployer à chaque push ne fonctionne que pour les dépôts connectés via une GitHub App, car c'est seulement alors que Coolify reçoit les webhooks. La même dépendance s'applique aux environnements de preview démarrés automatiquement : l'interrupteur n'existe que dans ce mode et est désactivé par défaut. Avec un dépôt public ou une deploy key, il reste la possibilité de déclencher manuellement un déploiement pour une pull request choisie.

L'adresse de l'environnement de preview est construite à partir d'un modèle, {{pr_id}}.{{domain}} par défaut. Une pull request numérotée 123 sur le domaine example.com atterrit donc sur 123.example.com, ce qui demande une entrée DNS wildcard et un certificat couvrant les sous-domaines. Quand une ressource a plusieurs domaines, c'est le premier qui entre dans le modèle.

Les variables d'environnement ont deux interrupteurs indépendants : la disponibilité pendant la phase de build et la disponibilité dans le conteneur en cours d'exécution. Les deux sont activés par défaut. Le panneau propose une vue développeur où tu modifies l'ensemble sous forme d'un simple fichier de clés et de valeurs.

Bash
# developer view: the whole variable set in .env format
NODE_ENV=production
DATABASE_URL=postgres://app:$DB_PASSWORD@postgres:5432/app_production

# a variable predefined by Coolify, the revision the image was built from
NEXT_PUBLIC_COMMIT=$SOURCE_COMMIT

# shared variables: team, project, environment
SMTP_HOST={{team.SMTP_HOST}}
SENTRY_ENVIRONMENT={{environment.NODE_ENV}}

Deux champs peuvent te sauver une soirée. L'interrupteur Literal désactive l'expansion des références, donc un mot de passe contenant un signe dollar cesse d'être lu comme le nom d'une autre variable. L'interrupteur Multiline préserve les sauts de ligne pour les clés privées et les certificats, et une valeur multiligne est entourée de guillemets simples au moment du déploiement, ce qui bloque l'interprétation par le shell. Les valeurs multilignes et les secrets verrouillés ne sont modifiables que dans la vue normale.

Les secrets de la phase de build sont un sujet à part. Par défaut, les variables de build passent en --build-arg, leurs valeurs restent dans les métadonnées de l'image et apparaissent dans docker history. L'option des build secrets Docker bascule cela vers --secret id=KEY,env=KEY, exige BuildKit et un moteur Docker à partir de la version 18.09, et Coolify ajoute lui-même la directive de syntaxe et les montages.

DOCKERFILE
# syntax=docker/dockerfile:1
FROM node:22-alpine
WORKDIR /app
COPY package.json package-lock.json ./
RUN --mount=type=secret,id=NPM_TOKEN npm ci
COPY . .
RUN --mount=type=secret,id=NPM_TOKEN npm run build
CMD ["node", "server.js"]

Au sein d'une étape donnée, la valeur du secret est visible comme variable d'environnement et ne laisse rien dans les couches de l'image. Coolify dérive une empreinte à partir des secrets, stockée sous le nom COOLIFY_BUILD_SECRETS_HASH, et l'utilise pour invalider le cache de build seulement quand un secret a réellement changé. Si BuildKit manque sur le serveur de build, le mécanisme retombe discrètement sur --build-arg, donc vérifie-le explicitement quand des tokens sensibles sont en jeu.

Publier un port sur l'hôte te coûte les rolling updates, car deux instances ne peuvent pas occuper le même port en même temps. Le rollback ne fonctionne que sur les images disponibles localement. Le health checking est activé par défaut pour chaque conteneur, et Traefik n'enverra pas de trafic vers un conteneur qui définit un check et le rate. C'est la cause la plus fréquente d'un 502 juste après le premier déploiement.

Sauvegardes, mises à jour et astreinte

C'est le cœur du choix entre Coolify et un service managé. Le panneau automatise les dumps de bases de données et peut les envoyer vers n'importe quel stockage compatible S3, mais c'est toi qui configures le calendrier, qui surveilles l'espace et, surtout, qui vérifies qu'une restauration fonctionne réellement. Une sauvegarde que personne n'a jamais restaurée n'est une sauvegarde que de nom.

Bash
# a custom-format dump, exactly what Coolify runs for PostgreSQL
pg_dump --format=custom --no-acl --no-owner --username postgres app_production

# restoring on a different machine
pg_restore --verbose --clean -h localhost -U postgres -d postgres \
  pg-dump-postgres-1697207547.dmp

# the equivalents for the other engines
mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" app_production
mariadb-dump -u root -p"$MYSQL_ROOT_PASSWORD" app_production
mongodump --authenticationDatabase=admin --uri="$MONGO_URI" --gzip --archive=dump.gz

Le format custom de PostgreSQL n'est pas un fichier SQL, donc tu le restaures avec pg_restore plutôt qu'avec psql. Mets dans ton calendrier une restauration trimestrielle sur une machine de test, car c'est le seul moyen de découvrir un problème avant le jour de la panne.

Les mises à jour de l'instance peuvent être laissées en automatique ou lancées à la main. Dans les deux cas, la responsabilité est la tienne : personne ne reviendra en arrière à ta place après une version défaillante, personne ne décroche le téléphone quand le proxy cesse de renouveler un certificat, et personne ne remarque que le disque s'est rempli de couches d'anciennes images. Ce dernier cas est fréquent, c'est pourquoi Coolify fournit un mécanisme de nettoyage Docker séparé qu'il faut activer volontairement.

Il y a ensuite ta dépendance envers le fournisseur de serveur. Quand la seule machine du seul centre de données tombe, l'application reste inaccessible jusqu'à ce que quelqu'un la remette en route. Les éditeurs managés répartissent ce risque sur de nombreuses régions et l'intègrent dans leur prix. Avec Coolify tu paies moins, et c'est toi qui répartis ce risque.

Il vaut mieux compter ce coût en heures avant de le compter en argent. Si tu fais tourner une douzaine de tes propres projets, une heure par mois pour les mises à jour et les vérifications est un excellent prix. Si tu sers un client en production et que personne ne te remplace pendant les vacances, cette même heure est parfois une mauvaise affaire.

Tarifs et variante managée

La variante auto-hébergée est gratuite pour toujours, sans restriction de fonctionnalités et sans plafond sur les déploiements, les équipes, les utilisateurs ou les serveurs connectés. Tu ne paies que le serveur sur lequel elle tourne.

Coolify Cloud coûte 5 dollars par mois comme prix de base couvrant deux serveurs connectés, plus 3 dollars par mois pour chaque serveur supplémentaire. La facturation annuelle retire 20 pour cent de la facture. Ce que tu achètes dans cette variante, c'est seulement le panneau exécuté sur l'infrastructure de l'éditeur : tu apportes tes propres serveurs d'application, chez n'importe quel fournisseur, et les applications se déploient toujours sur tes machines.

Les différences se résument à l'exploitation. Dans le cloud, l'éditeur maintient le panneau, effectue ses mises à jour et ses sauvegardes, fournit l'adresse app.coolify.io sans que tu configures un domaine à toi, et envoie des alertes par e-mail sans que tu montes un serveur SMTP. Sur les serveurs connectés à la variante cloud, ouvrir les ports 22, 80 et 443 suffit. Une limite est énoncée sans détour dans le tableau de l'éditeur : le nombre d'équipes est illimité, mais chaque équipe supplémentaire exige un abonnement séparé.

Un point important pour l'évaluation du risque : le cloud est construit sur ce même open source, donc résilier l'abonnement ne te retire pas l'outil. Il te reste les mêmes conteneurs sur les mêmes serveurs et tu peux monter le panneau toi-même. C'est une position très différente de celle des plateformes fermées, où partir signifie réécrire la configuration de déploiement de zéro.

Coolify face aux alternatives

CaractéristiqueCoolify auto-hébergéCoolify CloudVercelNetlifyRailway
Prix d'entrée0 USD plus le coût du serveur5 USD par mois pour deux serveursHobby 0 USD, Pro 20 USD par moisFree 0 USD, Personal 9 USD par moisFree 0 USD, Hobby à partir de 5 USD par mois
Où tourne l'appton serveurton serveurinfrastructure de l'éditeurinfrastructure de l'éditeurinfrastructure de l'éditeur
Qui met à jour le panneautoil'éditeurl'éditeurl'éditeurl'éditeur
Sauvegardes de l'instanceta configurationl'éditeursans objetsans objetsans objet
Facturation à l'usagenon, tu paies le serveurnon, tu paies les serveursoui, crédits et dépassementoui, créditsoui, à la seconde d'usage des ressources
Code sourceApache 2.0Apache 2.0ferméferméfermé

Le choix est en réalité une décision sur ce avec quoi tu préfères payer. Sous une charge stable et prévisible, un seul serveur à une douzaine de dollars par mois portera une douzaine d'applications qui coûteraient un multiple de cela chez un éditeur managé. Sous un trafic en dents de scie, et avec une équipe sans personne dédié à l'infrastructure, la facturation à l'usage et l'astreinte d'un autre valent leur prix.

Il existe aussi une troisième voie, utile avant même de poser quoi que ce soit sur un serveur. Montrer à un client un build en cours depuis ton laptop ne demande rien de plus qu'un tunnel comme Portless, sans rien de permanent à monter.

Le plus proche parent est Dokploy, qui résout le même problème mais découpe sa licence autrement. Le cœur est sous Apache 2.0, donc revendre de l'hébergement à des clients est permis, tandis que les répertoires marqués proprietary relèvent d'une licence source-available distincte, et l'usage en production de ce qu'ils contiennent, c'est-à-dire l'authentification unique, SCIM, le journal d'audit et les rôles personnalisés, exige un accord commercial. Deuxième point à noter lors d'un audit : le fichier de licence y est nommé LICENSE.MD en majuscules, donc un outil qui cherche LICENSE ou LICENSE.md ne le trouvera tout simplement pas.

Erreurs fréquentes

La première est d'installer Coolify sur une machine qui fait déjà tourner autre chose. La documentation recommande un serveur neuf, car l'installateur ajoute Docker, un proxy et ses propres réseaux, et un conflit sur le port 80 ou une configuration Nginx existante peut bloquer l'émission des certificats.

La deuxième est de compter sur UFW. Docker écrit des règles iptables avec traduction d'adresses qui contournent UFW, donc un port bloqué dans UFW peut rester joignable depuis le réseau. Utilise le pare-feu du fournisseur ou ufw-docker.

La troisième est de pointer le DNS vers le serveur principal dans une configuration multi-serveurs. La machine qui héberge le panneau ne transmet pas le trafic aux applications qui tournent ailleurs, donc l'enregistrement doit désigner le serveur cible.

La quatrième est d'attendre des environnements de preview automatiques sur un dépôt connecté par une deploy key. Cette fonctionnalité, comme le déploiement au push, ne fonctionne que via une connexion GitHub App.

La cinquième est de garder des tokens dans des variables de build sans secrets Docker. Les valeurs passées en --build-arg restent dans les métadonnées de l'image et peuvent être lues par quiconque a accès à l'image.

La sixième est de configurer des sauvegardes sans jamais tenter une restauration. Un dump PostgreSQL au format custom se restaure avec pg_restore plutôt qu'avec psql, et il vaut mieux l'apprendre un mardi tranquille que pendant une panne.

La septième est de sauter le nettoyage Docker. Les anciennes images et les couches de build grossissent jusqu'à remplir le disque, puis tout s'arrête d'un coup, y compris le panneau que tu utiliserais pour réparer.

FAQ

Coolify est-il vraiment gratuit ?

Oui. La variante auto-hébergée est gratuite pour toujours, sans restriction de fonctionnalités et sans plafond sur les serveurs, les déploiements ou les utilisateurs. Seul Coolify Cloud est payant, c'est-à-dire le panneau maintenu par l'éditeur, à 5 dollars par mois pour deux serveurs connectés plus 3 dollars pour chaque serveur supplémentaire. Les serveurs d'application sont les tiens dans les deux variantes.

Quel serveur suffit pour commencer ?

La documentation donne un minimum de deux cœurs, 2 Go de mémoire et 30 Go d'espace, sur amd64 ou arm64. L'éditeur recommande de la marge au-delà de ce minimum, car les processus de build partagent la même mémoire. Pour quelque chose de sérieux, séparer la machine du panneau des machines d'application est judicieux.

Coolify remplacera-t-il Vercel ?

Pour les déploiements depuis un dépôt, les certificats et les environnements de preview, il se comporte de façon similaire. Il ne remplacera pas un réseau de diffusion de contenu, des fonctions edge ou une présence simultanée dans plusieurs régions, car l'application se trouve sur ton serveur à un seul endroit. Répartir le contenu géographiquement demande une couche supplémentaire.

Que se passe-t-il si je résilie l'abonnement cloud ?

Le cloud est construit sur le même open source sous Apache 2.0, et les applications tournent sur tes serveurs en permanence. Tu peux installer le panneau toi-même et continuer à faire tourner les mêmes ressources. Tu ne perds pas l'accès à l'outil avec l'abonnement.

Coolify peut-il tourner sur un Raspberry Pi ?

Oui, sur Raspberry Pi OS 64 bits. L'architecture arm64 est prise en charge et la documentation contient un guide d'installation dédié. Garde en tête les exigences minimales de mémoire, et souviens-toi qu'une carte mémoire est un mauvais support pour une base de données en production.

Quels ports dois-je ouvrir ?

Accéder au panneau par adresse IP demande 8000 pour le panneau, 6001 pour la communication en temps réel, 6002 pour le terminal, plus 22, 80 et 443. Une fois que ton propre domaine pointe vers le panneau, les trois premiers peuvent être fermés. Les serveurs connectés à Coolify Cloud n'ont besoin que de 22, 80 et 443.

La documentation se trouve sur le site de Coolify, les conditions de la variante managée sur la page des tarifs, et le code source dans le dépôt GitHub.

À lire aussi