Guide de Configuration Coolify sur VPS : Votre Propre Vercel

Coolify est un PaaS auto-hébergé qui transforme votre VPS en une plateforme similaire à Vercel/Netlify. Déployez des applications depuis Git, SSL automatique, déploiements sans interruption — le tout sur du matériel que vous contrôlez.

Qu’est-ce que Coolify ?

Coolify gère la complexité de l’infrastructure :

• Intégration Git — Poussez pour déployer
• SSL automatique — Let’s Encrypt intégré
• Langages multiples — Node, Python, PHP, Go, Rust, sites statiques
• Bases de données — PostgreSQL, MySQL, Redis, MongoDB en un clic
• Support Docker — Déployez n’importe quel Dockerfile
• Webhooks — Déploiements automatiques à chaque push

Considérez-le comme un Heroku/Vercel auto-hébergé pour une fraction du coût.

Pourquoi Coolify plutôt que Vercel ?

Facteur	Vercel	Coolify sur VPS
Coût (3 apps)	60$/mois+	5-15$/mois
Ressources	Limitées	VPS complet
Verrouillage fournisseur	Élevé	Aucun
Démarrages à froid	Oui	Non
Domaines personnalisés	Limités en gratuit	Illimités
Hébergement BDD	Coût supplémentaire	Inclus

Seuil de rentabilité : Si vous payez >20$/mois sur Vercel, Coolify vous fait économiser.

Configuration Requise pour le VPS

Coolify nécessite :

• Minimum : 2 vCPU, 2Go RAM, 30Go de stockage
• Recommandé : 4 vCPU, 4Go RAM, 50Go+ de stockage
• OS : Ubuntu 22.04+ ou Debian 12+
• Ports : 80, 443, 8000 (tableau de bord)

Fournisseurs VPS Recommandés

Fournisseur	Plan	Caractéristiques	Prix
Hostinger	KVM1	1 vCPU, 4Go RAM	4,99$/mois
Hetzner	CX21	2 vCPU, 4Go RAM	5,39€/mois
Vultr	VC2	2 vCPU, 4Go RAM	24$/mois

Meilleur rapport qualité-prix : Hostinger KVM1 — 4Go de RAM pour 4,99$ gère facilement 5 à 10 applications.

Guide d’Installation

Étape 1 : Créer Votre VPS

En utilisant Hetzner comme exemple :

1. Inscrivez-vous sur Hetzner Cloud
2. Créez un Projet → Ajouter un Serveur
3. Sélectionnez : Ubuntu 22.04, CX21 (2 vCPU, 4Go RAM)
4. Ajoutez votre clé SSH
5. Créez le serveur, notez l’adresse IP

Étape 2 : Configurer Votre Domaine

Avant l’installation, configurez le DNS :

A    coolify.votredomaine.com    → votre-ip-serveur
A    *.coolify.votredomaine.com  → votre-ip-serveur

Le wildcard est important — chaque application obtient un sous-domaine.

Étape 3 : Se Connecter et Préparer

ssh root@your-server-ip

# Update system
apt update && apt upgrade -y

# Set hostname (optional but nice)
hostnamectl set-hostname coolify

# Reboot to apply updates
reboot

Étape 4 : Installer Coolify

Une seule commande installe tout :

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

Cela installe :

• Docker Engine
• L’application Coolify
• Le reverse proxy Traefik
• PostgreSQL pour les données Coolify

L’installation prend 2 à 5 minutes.

Étape 5 : Accéder au Tableau de Bord

Ouvrez dans votre navigateur :

http://your-server-ip:8000

Ou si le DNS est prêt :

http://coolify.yourdomain.com:8000

Créez votre compte administrateur lors de la première visite.

Étape 6 : Configurer le SSL

Dans le tableau de bord Coolify :

1. Allez dans Settings → Configuration
2. Définissez votre Instance FQDN sur https://coolify.yourdomain.com
3. Activez Let’s Encrypt
4. Entrez votre email pour les notifications SSL
5. Enregistrez et attendez le certificat

Accédez maintenant via https://coolify.yourdomain.com

Déployer Votre Première Application

Option A : Depuis un Dépôt Git

1. Sources → Ajouter GitHub/GitLab
2. Autorisez l’accès OAuth
3. Projects → Nouveau Projet → Nouvelle Ressource
4. Sélectionnez Public Repository ou votre compte connecté
5. Entrez l’URL du dépôt (ex. https://github.com/you/app)
6. Coolify détecte automatiquement : Node, Python, PHP, statique, Docker
7. Cliquez sur Deploy

Coolify compile et déploie automatiquement. Vous obtenez une URL comme : https://app-xxxx.coolify.yourdomain.com

Option B : Avec Docker Compose

Pour les projets Docker existants :

1. Projects → Nouvelle Ressource → Docker Compose
2. Collez ou liez votre fichier compose :

version: '3'
services:
  app:
    image: nginx:alpine
    ports:
      - 80:80

3. Déployez

Option C : Déployer depuis un Dockerfile

1. Créer une ressource → Dockerfile
2. Liez au dépôt contenant le Dockerfile
3. Coolify compile et déploie

Déploiements Courants

Application Next.js

# In Coolify:
# 1. Add Git source
# 2. Select your Next.js repo
# 3. Coolify auto-detects Node, uses build output

Commande de build : npm run build Commande de démarrage : npm start

Python/FastAPI

# Dockerfile
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Site Statique

Pointez simplement vers un dépôt contenant un index.html — Coolify le sert automatiquement.

WordPress

1. New Resource → Services → WordPress
2. Un clic déploie WordPress + MySQL
3. SSL et domaine gérés automatiquement

Ajouter des Bases de Données

PostgreSQL

1. Resources → Nouvelle Ressource → PostgreSQL
2. Définissez le mot de passe
3. Déployez

La chaîne de connexion apparaît dans le tableau de bord :

postgresql://user:password@postgres-xxxx:5432/postgres

Utilisez-la dans vos applications via les variables d’environnement.

Redis

Même processus :

1. Nouvelle Ressource → Redis
2. Déployez
3. Utilisez redis://redis-xxxx:6379 dans vos applications

MySQL/MariaDB

1. Nouvelle Ressource → MySQL ou MariaDB
2. Configurez
3. Déployez

Déploiements Automatiques

Webhooks GitHub

Coolify configure automatiquement les webhooks lorsque vous connectez GitHub :

1. Push sur la branche main
2. Le webhook se déclenche
3. Coolify récupère, compile, déploie
4. Basculement sans interruption

Déclenchements Manuels

Dans chaque application :

• Cliquez sur Redeploy pour un déclenchement manuel
• Utilisez l’API pour l’intégration CI/CD :

curl -X POST https://coolify.yourdomain.com/api/v1/deploy \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"uuid": "app-uuid"}'

Variables d’Environnement

Par Application

1. Ouvrez l’application dans le tableau de bord
2. Onglet Environment Variables
3. Ajoutez des paires clé-valeur :

DATABASE_URL=postgresql://...
API_KEY=secret123
NODE_ENV=production

Partagées Entre Applications

1. Projects → Sélectionnez le projet
2. Shared Variables
3. Celles-ci sont injectées dans toutes les applications du projet

Domaines Personnalisés

Ajouter un Domaine à une Application

1. Ouvrez l’application → Settings
2. Domains → Ajouter un domaine
3. Entrez : app.votredomaine.com
4. Le SSL est provisionné automatiquement

Domaines Multiples

Ajoutez autant de domaines que nécessaire :

app.votredomaine.com
www.votredomaine.com
votredomaine.com

Tous pointent vers la même application.

Stratégie de Sauvegarde

Sauvegardes de Base de Données

Coolify prend en charge les sauvegardes planifiées :

1. Ouvrez la ressource base de données
2. Backups → Activer
3. Définissez la planification (quotidienne recommandée)
4. Configurez la destination S3/Minio

Données d’Application

Pour les applications avec des données persistantes :

# On VPS, backup Docker volumes
docker run --rm -v app_data:/data -v /backup:/backup \
  alpine tar czf /backup/app-backup.tar.gz /data

Snapshots Complets du VPS

Utilisez la fonctionnalité de snapshots de votre fournisseur :

• Hetzner : 0,012€/Go/mois
• Hostinger : Inclus chaque semaine
• Vultr : 20% du coût du VPS

Conseils de Performance

1. Activer le Swap

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab

2. Nettoyer les Ressources Docker

# Weekly cleanup
docker system prune -a --volumes -f

Ou activez-le dans les paramètres Coolify.

3. Surveiller les Ressources

# Check container stats
docker stats

Le tableau de bord Coolify affiche l’utilisation des ressources par application.

4. Mise à l’Échelle Horizontale

Pour les applications à fort trafic, ajoutez des instances VPS supplémentaires et utilisez la gestion de serveurs de Coolify pour distribuer les déploiements.

Dépannage

L’Application ne se Déploie Pas

# Check logs
docker logs coolify

# Check app build logs in dashboard
# Resources → App → Deployments → View logs

Le SSL ne Fonctionne Pas

1. Vérifiez que le DNS pointe correctement
2. Attendez la propagation (jusqu’à 24h)
3. Vérifiez que les ports 80/443 sont ouverts dans le pare-feu
4. Redémarrez Traefik : docker restart coolify-proxy

Espace Disque Insuffisant

# Check usage
df -h

# Clean Docker
docker system prune -a

# Remove old deployments in Coolify settings

Connexion à la Base de Données Refusée

1. Assurez-vous que le conteneur de base de données est en cours d’exécution
2. Utilisez le nom d’hôte Docker interne (ex. postgres-xxxx)
3. Vérifiez les identifiants dans le tableau de bord Coolify

Coolify vs Alternatives

Plateforme	Complexité	Idéal Pour
Coolify	Faible	PaaS général, multi-applications
Dokploy	Faible	Similaire à Coolify
CapRover	Moyenne	Orienté Docker
Portainer	Faible	Gestion de conteneurs
Kubernetes	Élevée	Grande échelle

Coolify l’emporte sur la simplicité tout en offrant suffisamment de puissance pour la plupart des projets.

FAQ

Combien d’applications Coolify peut-il exécuter ?

Sur un VPS de 4Go : 5 à 15 applications légères. Plus avec une gestion attentive des ressources.

Coolify est-il prêt pour la production ?

Oui, de nombreuses entreprises l’utilisent. La version v4 est stable et activement maintenue.

Puis-je utiliser mon propre registre Docker ?

Oui, configurez-le dans Settings → Docker Registries.

Coolify prend-il en charge les monorepos ?

Oui, spécifiez le sous-répertoire contenant votre application.

Comment mettre à jour Coolify ?

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

La même commande d’installation met à jour vers la dernière version.

Résumé

Coolify transforme un VPS à 5-15$/mois en une plateforme de déploiement qui rivalise avec Vercel/Netlify. Pour les développeurs et les petites équipes, c’est le compromis idéal entre le Docker fait-maison et un PaaS coûteux.

Configuration Recommandée :

Composant	Choix	Coût
VPS	Hostinger KVM1	4,99$/mois
Plateforme	Coolify	Gratuit
Domaines	Cloudflare	Gratuit
Total		4,99$/mois

Commencez ici : Hostinger VPS → Installez Coolify → Déployez vos applications.