Coolify est une alternative open source et auto-hébergée à Heroku et Vercel, qui te permet de gérer facilement tes serveurs, applications et bases de données.
Le tableau de bord intuitif de Coolify simplifie l’auto-hébergement. Tu gardes le contrôle total de ton infrastructure, automatises tes déploiements GitHub et réduis tes coûts liés au cloud.
Dans ce guide, nous allons te montrer étape par étape comment configurer Coolify, préconfigurer ton compte administrateur et régler tout ce que tu dois savoir.
Coolify est léger, mais sa consommation de ressources peut augmenter considérablement selon le nombre d’applications déployées, de compilations Docker et de bases de données en cours d’exécution. Voici la configuration matérielle recommandée pour utiliser Coolify sur ton serveur ou serveur dédié :
| Matériel | Minimum | Recommandé |
|---|---|---|
| CPU | 2 cœurs vCPU | 4 cœurs vCPU |
| RAM | 2 Go | 4 Go ou plus |
| Espace disque | 30 Go | 50 Go ou plus |
Avant d’installer Coolify, connecte-toi à ton serveur et vérifie que le système d’exploitation est à jour. Tu dois te connecter via SSH avec un accès root. Si tu as besoin d’aide, consulte notre guide sur la première connexion SSH.
Authentification par clé SSH
Nous te recommandons vivement de configurer l’authentification par clé SSH plutôt que par mot de passe. Pour savoir comment procéder, consulte notre guide sur la configuration d’une clé SSH.
Une fois connecté à ton serveur, mets à jour les paquets système et installe curl, nécessaire au téléchargement du script d’installation de Coolify :
sudo apt update && sudo apt upgrade -y && sudo apt install curl -y
Coolify applique des règles de sécurité strictes à ton compte administrateur. Avant de lancer le script d’installation, prépare les identifiants de l’utilisateur root en respectant les exigences suivantes :
- Nom d’utilisateur
- 3 caractères minimum
- 255 caractères maximum
- Seules les lettres, les chiffres, les espaces, les traits de soulignement et les traits d’union sont autorisés
- Adresse e-mail
- Doit être une adresse e-mail valide
- Doit disposer d’un enregistrement DNS valide
- 255 caractères maximum
- Mot de passe
- 8 caractères minimum
- Doit contenir des lettres majuscules et minuscules
- Au moins un chiffre
- Au moins un caractère spécial
- Ne doit pas être un mot de passe courant ou compromis
Coolify propose un script d’installation rapide et automatisé. Pour sécuriser l’installation, nous définissons au préalable les identifiants de l’administrateur root à l’aide de variables d’environnement. Cela empêche tout accès non autorisé pendant la configuration.
Exécute la commande suivante en remplaçant le nom d’utilisateur, l’adresse e-mail et le mot de passe par tes identifiants sécurisés :
env ROOT_USERNAME=zaphosting ROOT_USER_EMAIL=info@zap-hosting.com ROOT_USER_PASSWORD=zaphosting bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Open source
Tu trouveras le code source du script d’installation dans le dépôt officiel de Coolify
Le script installe automatiquement Docker, configure les réseaux nécessaires et prépare les conteneurs Coolify. Selon le matériel de ton serveur, cela peut prendre quelques minutes.
Une fois l’installation terminée, tu peux ouvrir le tableau de bord dans ton navigateur. Saisis l’adresse IP de ton serveur avec le port 8000 : http://[deine_server_ip]:8000
Comme tu as déjà indiqué tes identifiants dans la commande d’installation, tu arrives directement sur l’écran de connexion et non dans l’assistant de configuration.
Connecte-toi avec l’adresse e-mail et le mot de passe que tu as utilisés dans le terminal.
Après t’être connecté, commence par configurer un nom de domaine personnalisé. L’accès via l’adresse IP (http://[deine_server_ip]:8000) n’est pas sécurisé.
Avec un nom de domaine, Coolify peut créer automatiquement des certificats SSL gratuits pour ton tableau de bord et toutes tes futures applications.
Accède à la gestion DNS de ton fournisseur de domaine et ajoute deux nouvelles entrées A pointant vers ton serveur. Si ton domaine est enregistré chez ZAP-Hosting, consulte notre guide sur les enregistrements de domaine pour les configurer :
| Nom / Hôte | Type | Valeur | TTL |
|---|---|---|---|
@ | A | [deine_server_ip] | Auto / Faible |
* | A | [deine_server_ip] | Auto / Faible |
Routage DNS
- L’entrée
@permet à Coolify d’utiliser le domaine racine - L’entrée générique
*permet à Coolify de router automatiquement tous les nouveaux sous-domaines (par exempleapi.[deine_domain]), sans que tu aies à créer des entrées DNS pour chaque projet.
Pour sécuriser ton instance Coolify avec un certificat SSL, attribue-lui un nom de domaine. Dans le menu de gauche, va dans Paramètres et repère le champ Instance Domain. Saisis ton domaine avec https:// (par exemple https://coolify.[deine_domain]). Enregistre la modification.
