Installer Coolify : alternative self-hosted à Vercel / Heroku

Introduction

Coolify est une plateforme self-hosted qui transforme un VPS en environnement de déploiement automatisé. Connectez votre dépôt GitHub/GitLab, et chaque push déploie automatiquement votre application avec SSL Let's Encrypt, reverse proxy, monitoring et backups intégrés.

Services supportés : Node.js, Next.js, Nuxt, Astro, PHP/Laravel, Python/Django, Go, Rust, Docker, et plus de 100 templates en un clic (Plausible, n8n, Ghost, Outline, NocoDB, Supabase…).

Prérequis

• VPS Debian 12 ou Ubuntu 22.04+ avec au minimum 4 GB RAM et 30 GB de disque
• Accès root
• Un domaine pointant vers le VPS (ex : coolify.votre-domaine.com)
• Ports 80, 443, 6001 (Coolify dashboard) et 8000 (Coolify proxy) ouverts

Étape 1 : Installation en une commande

Coolify fournit un installeur officiel qui détecte la distribution, installe Docker et déploie la stack complète :

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

L'installation prend environ 5 à 10 minutes. À la fin, l'URL de connexion s'affiche :

http://IP_DE_VOTRE_VPS:8000

Étape 2 : Première connexion et création admin

Ouvrez l'URL dans votre navigateur, créez votre compte administrateur (email + mot de passe fort).

Étape 3 : Configurer le domaine

Dans Settings → General :

• Instance Domain : coolify.votre-domaine.com
• Activez Force HTTPS

Coolify utilise Traefik en interne comme reverse proxy et obtient automatiquement les certificats Let's Encrypt.

Assurez-vous que les enregistrements DNS suivants sont en place chez votre registrar :

A     coolify.votre-domaine.com    →   IP_DE_VOTRE_VPS
A     *.coolify.votre-domaine.com  →   IP_DE_VOTRE_VPS

Le wildcard permet à Coolify d'attribuer automatiquement un sous-domaine aux applications déployées.

Étape 4 : Connecter une source Git

Sources → Add a new source. Choisissez GitHub (recommandé) :

1. Cliquez sur Create a new GitHub App
2. Coolify vous redirige vers GitHub pour créer une App OAuth
3. Autorisez l'accès aux dépôts que vous voulez déployer

Étape 5 : Créer un projet et déployer une app

Projects → Add → New Project (donnez un nom, ex : MonSite). Dans le projet :

• + New Resource → Application
• Choisissez votre source Git
• Sélectionnez le dépôt et la branche (main par défaut)
• Build Pack : Coolify détecte automatiquement (Nixpacks, Dockerfile, Static, etc.)
• Configurez le Domains (ex : app.votre-domaine.com)
• Ajoutez vos Environment Variables
• Cliquez sur Deploy

Le premier déploiement prend 2-5 minutes. Les suivants sont plus rapides grâce au cache.

Étape 6 : Auto-deploy sur git push

Dans l'onglet Webhooks de votre application :

• Activez Auto Deploy
• Coolify configure automatiquement un webhook GitHub

Désormais, chaque git push sur la branche déclenche un redéploiement automatique.

Étape 7 : Ajouter une base de données

+ New Resource → Database dans votre projet. Choisissez PostgreSQL, MySQL, MongoDB, Redis, MariaDB, KeyDB, Dragonfly ou ClickHouse.

Coolify provisionne le service et vous donne :

• L'URL de connexion interne (utilisable depuis vos apps du même projet)
• L'URL publique (optionnelle, accessible depuis l'extérieur)
• Les identifiants

Connectez votre application en ajoutant la variable d'environnement :

DATABASE_URL=postgresql://user:password@postgresql-xxxxx:5432/dbname

Étape 8 : Déployer un service depuis un template

+ New Resource → Service. Plus de 100 services prêts à l'emploi : Plausible Analytics, n8n, Ghost, Outline, Vaultwarden, NocoDB, Uptime Kuma, MinIO, Metabase, etc.

Sélectionnez, configurez les variables si nécessaire, et déployez.

Étape 9 : Sauvegardes automatiques

Dans chaque base de données, onglet Backups :

• Activez la sauvegarde automatique
• Choisissez la fréquence (cron)
• Destination : disque local, S3, Backblaze B2, etc.
• Configurez la rétention

Étape 10 : Monitoring intégré

Coolify affiche dans Server → Resources :

• CPU, RAM, disque en temps réel
• Logs en streaming par container
• Healthchecks par application
• Alertes Discord, Slack, email, Telegram

Dépannage

Coolify ne démarre pas

Inspectez les conteneurs :

sudo docker ps -a | grep coolify
sudo docker logs coolify --tail 100

Certificat SSL non généré

Vérifiez que :

• Port 80 est ouvert (Let's Encrypt valide via HTTP-01)
• Le DNS pointe bien vers le VPS
• Cloudflare est en mode DNS only (nuage gris) pendant la génération

Manque de RAM

Coolify + Traefik + plusieurs apps consomment vite. Surveillez :

free -h
sudo docker stats

Migrez sur un VPS plus puissant (Ryzen recommandé) si vous saturez.

Commandes utiles

# Mettre à jour Coolify
sudo bash -c "$(curl -fsSL https://cdn.coollabs.io/coolify/upgrade.sh)"

# Voir tous les conteneurs Coolify
sudo docker ps --filter "label=coolify.managed=true"

# Sauvegarder Coolify lui-même
sudo tar -czf coolify-backup-$(date +%F).tar.gz /data/coolify

# Redémarrer Coolify
cd /data/coolify/source && sudo docker compose restart

Conclusion

Vous avez désormais votre propre PaaS sur VeryCloud, sans frais récurrents par déploiement. Coolify est particulièrement intéressant sur un VPS Ryzen où la puissance compense largement le coût des grosses plateformes commerciales pour des charges légères à moyennes.

Ressources

• Site officiel : https://coolify.io
• Documentation : https://coolify.io/docs
• GitHub : https://github.com/coollabsio/coolify