Coolify : installer et configurer sur un VPS

Ce guide vaut pour Coolify v4, d'après la documentation d'installation consultée le 14 octobre 2026.

Ce qu'il faut avant de commencer

• Un serveur Linux 64 bits (amd64 ou arm64) sous Ubuntu LTS ou Debian, avec un accès SSH et les droits sudo. La documentation cite Ubuntu 20.04, 22.04 et 24.04 ; elle ne liste pas encore de version plus récente.
• Au moins 2 cœurs, 2 Go de mémoire et 10 Go de disque libre. Le serveur construit les images de vos applications : prévoyez davantage si vous en déployez plusieurs.
• Un nom de domaine dont vous pouvez modifier les enregistrements DNS, pour servir le tableau de bord et les applications en HTTPS.

Les ports dont Coolify a besoin

D'après la page consacrée au pare-feu :

Une fois le tableau de bord servi sur un domaine, les ports 8000, 6001 et 6002 peuvent être refermés : tout passe alors par 80 et 443.

Installer Coolify

La commande d'installation officielle, à lancer en tant que root :

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash

1. Connectez-vous au serveur en SSH avec un compte qui a les droits sudo.
2. Lancez la commande ci-dessus et attendez la fin du script. Il installe ou réutilise Docker, télécharge les conteneurs de Coolify et affiche l'adresse du tableau de bord, en http://<adresse-du-serveur>:8000.
3. Sauvegardez le fichier de secrets /data/coolify/source/.env. Il contient la clé de chiffrement de l'instance, sans laquelle une restauration est impossible.

Créer le compte administrateur sans exposer la page d'inscription

La documentation le dit clairement : la première personne qui atteint la page d'inscription devient administrateur de l'instance. Tant que le port 8000 est ouvert sur Internet, n'importe qui peut prendre la place.

La façon la plus sûre est de passer par un tunnel SSH, sans ouvrir le port. Depuis votre poste :

ssh -L 8000:localhost:8000 -L 6001:localhost:6001 -L 6002:localhost:6002 utilisateur@adresse-du-serveur

Ouvrez ensuite http://localhost:8000 dans votre navigateur : la page vient du serveur, à travers la connexion SSH chiffrée, et personne d'autre ne la voit. Créez le compte administrateur, avec un mot de passe long.

L'autre façon consiste à fixer le compte avant l'installation, avec les variables ROOT_USERNAME, ROOT_USER_EMAIL et ROOT_USER_PASSWORD décrites dans la documentation. La page d'inscription n'est alors jamais exposée.

Servir le tableau de bord sur votre domaine en HTTPS

1. Créez un enregistrement DNS de type A, par exemple coolify.votre-domaine.fr, qui pointe vers l'adresse IP du serveur.
2. Dans Coolify, ouvrez Settings, puis le champ du domaine de l'instance (Instance's Domain), saisissez https://coolify.votre-domaine.fr et enregistrez.
3. Attendez l'émission du certificat par le proxy de Coolify, qui passe par les ports 80 et 443, puis ouvrez le tableau de bord à sa nouvelle adresse.
4. Refermez les ports 8000, 6001 et 6002 s'ils étaient ouverts. Le tableau de bord, le direct et le terminal passent désormais par HTTPS.

Les applications que vous déployez reçoivent chacune leur domaine de la même façon, dans leur propre écran de configuration, avec un certificat Let's Encrypt émis automatiquement.

Sur un VPS Hubspace

• Docker et le module docker compose sont déjà installés depuis le dépôt officiel de Docker. Le compte admin a les droits sudo sans mot de passe : la commande d'installation ci-dessus fonctionne telle quelle.
• Les systèmes proposés sont Ubuntu 26.04 LTS et Debian 13, plus récents que les versions citées par la documentation de Coolify.
• Seuls les ports 22, 80 et 443 sont ouverts depuis Internet. Les ports 8000, 6001 et 6002 sont donc fermés d'office : le tunnel SSH décrit plus haut est la façon la plus simple de créer le compte, sans rien ouvrir. Si vous préférez ouvrir le port 8000 le temps de la configuration, créez une règle dans votre espace client, onglet « Firewalls » de votre VPS, et retirez-la une fois le domaine en place (voir ouvrir un port).
• Les ports 25 et 465 sortants sont bloqués : pour les notifications par courriel de Coolify, utilisez un service d'envoi externe.
• Une taille Essentiel S (2 vCPU, 4 Go) suffit pour Coolify et quelques applications légères. Pour les constructions fréquentes, voyez les serveurs VPS plus grands.

Pour comparer avec un outil voisin, voir Dokploy : installer et configurer.

Questions fréquentes