Coolify self-hosted 2026 : guide complet (PaaS open source pour PME africaines)

Si vous gérez une PME, une équipe de développement ou même un projet personnel ambitieux en Afrique de l’Ouest, vous avez probablement vécu cette frustration récurrente : Heroku devient hors de prix dès la moindre montée en charge, Vercel facture en dollars chaque appel API, AWS et GCP demandent un ingénieur dédié rien que pour comprendre la facturation, et les pipelines DevOps maison absorbent un temps précieux qui devrait servir à coder le produit. Coolify change la donne. C’est une plateforme PaaS open-source que vous installez sur votre propre VPS — un Hetzner à 4 € par mois, un OVH Dakar, un VPS chez Maktoob ou DigitalRise — et qui vous offre l’expérience Heroku/Vercel sans la facture mensuelle, sans dépendance à un fournisseur cloud, avec vos données chez vous.

Ce guide couvre tout ce qu’il faut savoir pour démarrer Coolify en production en 2026 : pourquoi le choisir, comment l’installer proprement, comment connecter Git, comment déployer ses premières applications, comment gérer les bases de données, les sauvegardes, le monitoring, la haute disponibilité, et surtout comment l’adapter au contexte ouest-africain — bande passante limitée, paiement en FCFA via Mobile Money, hébergeurs locaux, contraintes de souveraineté numérique. À la fin de ce guide, vous aurez une instance Coolify productive, sécurisée, sauvegardée et capable d’héberger des dizaines d’applications.

Pourquoi Coolify en 2026 ?

Coolify est un projet open-source maintenu activement, créé par Andras Bacsai et soutenu par une communauté grandissante. La version 4.x stable en 2026 cumule plus de 30 000 étoiles GitHub, ce qui en fait l’un des projets PaaS auto-hébergés les plus populaires aux côtés de CapRover (qui a vieilli) et Dokploy (le challenger minimaliste). Le projet se positionne explicitement comme une alternative auto-hébergée à Heroku, Netlify, Vercel et DigitalOcean App Platform. La promesse est simple : déployer une application Node.js, Python, PHP, Go, Rust, Ruby, Java ou un site statique en cliquant un bouton, depuis un dépôt Git, sans toucher au moindre Dockerfile si vous ne le souhaitez pas.

• Gratuit et open-source sous licence Apache 2.0, sans aucune limite d’applications, de domaines, d’utilisateurs ni de bandwidth — les seules limites sont celles de votre VPS.
• Auto-hébergé par défaut : vos données restent sur vos serveurs, à l’endroit que vous choisissez. C’est important pour le RGPD, la souveraineté numérique africaine, et toute donnée sensible (santé, finance, éducation).
• Multi-serveurs : un seul Coolify peut piloter plusieurs serveurs distants via SSH, ce qui permet de séparer staging et production, ou de répartir les charges sur plusieurs nœuds.
• Webhooks Git intégrés : un push sur main déclenche automatiquement un déploiement, sans webhook manuel à maintenir.
• Buildpacks Nixpacks ou Dockerfile au choix : Coolify détecte 90 % des frameworks sans que vous écriviez un seul fichier de configuration.
• Reverse proxy Traefik avec HTTPS automatique via Let’s Encrypt et renouvellement transparent.
• Marketplace d’applications : Plausible, Umami, Ghost, Pocketbase, Uptime Kuma, NocoDB, n8n, Forgejo, Gitea, MinIO… une centaine d’applications pré-configurées en un clic.
• Bases de données managées : PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, Dragonfly, ClickHouse — provisionnées en un clic, sauvegardées automatiquement.

Coolify vs alternatives : un mot

Si vous hésitez entre plusieurs PaaS auto-hébergés, lisez notre comparatif honnête Coolify vs Dokploy vs CapRover. En résumé : Coolify est le plus complet en fonctionnalités et UX, Dokploy est le plus léger en RAM, CapRover est le plus mature mais l’écosystème évolue moins vite. Pour 80 % des cas d’usage en PME africaine, Coolify est le choix pragmatique.

Prérequis matériels et logiciels

• Un VPS avec au minimum 2 vCPU et 4 Go de RAM pour démarrer ; 8 Go RAM recommandés en production réelle si vous comptez héberger plusieurs applications avec leurs bases de données.
• Système d’exploitation : Ubuntu 22.04, 24.04 LTS ou Debian 12 — ce sont les distributions testées en priorité par le projet. Évitez les rolling releases ou les distributions exotiques.
• Un nom de domaine pointant sur le VPS (DNS A record, ou AAAA si IPv6).
• Accès root SSH avec clef publique (jamais en mot de passe en production).
• Un firewall basique configuré (UFW ou iptables) avec ports 22, 80 et 443 ouverts.
• Niveau attendu : intermédiaire — vous savez utiliser SSH, ajuster un /etc/hosts, lire les logs Docker basique.
• Temps : 30 minutes pour l’installation, 1 à 2 heures pour configurer le premier projet en production avec base, HTTPS et backups.

Étape 1 — Préparer le VPS

Avant d’installer Coolify, sécurisez le VPS. Connectez-vous en SSH puis :

# Mettre à jour le système
apt update && apt upgrade -y

# Installer le firewall et les outils de base
apt install -y ufw fail2ban htop curl

# Configurer UFW
ufw default deny incoming
ufw default allow outgoing
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw --force enable

# Désactiver le login root par mot de passe
sed -i 's/#PermitRootLogin.*/PermitRootLogin prohibit-password/' /etc/ssh/sshd_config
sed -i 's/#PasswordAuthentication.*/PasswordAuthentication no/' /etc/ssh/sshd_config
systemctl restart ssh

# Créer un utilisateur non-root (optionnel mais recommandé)
adduser coolify
usermod -aG sudo coolify
mkdir -p /home/coolify/.ssh
cp ~/.ssh/authorized_keys /home/coolify/.ssh/
chown -R coolify:coolify /home/coolify/.ssh
chmod 700 /home/coolify/.ssh
chmod 600 /home/coolify/.ssh/authorized_keys

Configurez aussi un swap de 2 Go si votre VPS n’en a pas — ça évite des crashes lors des builds Next.js gourmands :

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

Étape 2 — Installer Coolify

Le projet fournit un script d’installation officiel qui détecte votre OS, installe Docker, génère les clefs et lance les conteneurs nécessaires. Connectez-vous en SSH sur votre serveur frais et exécutez :

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

Le script vous demandera de choisir un mot de passe pour l’instance racine et lancera Coolify sur le port 8000. Comptez 5 à 10 minutes selon la bande passante de votre VPS — au Sénégal sur un Starlink correct, c’est environ 7 minutes en moyenne ; depuis un VPS Hetzner Helsinki, c’est sous les 4 minutes. Le script télécharge plusieurs gigaoctets d’images Docker (Coolify lui-même, Traefik, Postgres, Redis), donc surveillez l’usage disque si votre VPS est petit.

Une fois le script terminé, ouvrez votre navigateur sur http://IP-DE-VOTRE-VPS:8000 et créez le compte administrateur (email + mot de passe fort, gérez-le dans un password manager). Configurez immédiatement votre nom de domaine principal dans Settings → Instance Settings — par exemple coolify.exemple.sn — et activez Let’s Encrypt pour obtenir un certificat HTTPS sur le panel lui-même. Plus jamais d’IP brute exposée.

Étape 3 — Sécuriser l’instance Coolify

• Activer la 2FA sur votre compte admin (Profile → Security). Coolify supporte les apps TOTP standard (Authy, Aegis, Bitwarden Authenticator).
• Restreindre l’accès au panel par IP si possible — utile si vous avez une IP fixe au bureau, sinon laissez ouvert avec 2FA.
• Configurer les notifications : Coolify peut envoyer des alertes par email, Slack, Discord ou Telegram en cas de déploiement raté ou de serveur down.
• Désactiver l’inscription publique par défaut, pour éviter qu’un visiteur ne crée un compte.

Étape 4 — Connecter votre source Git

Coolify supporte GitHub, GitLab, Gitea, Forgejo et n’importe quel dépôt Git accessible par SSH. Pour GitHub, allez dans Sources → Add → GitHub App. Coolify vous guide pour créer une GitHub App de votre organisation, ce qui permet de déployer automatiquement à chaque push, sans webhook manuel à maintenir. La création de la GitHub App prend deux minutes et la même app peut servir à plusieurs projets.

Si vous utilisez Forgejo ou Gitea (que je recommande pour héberger votre code en local plutôt que de tout confier à GitHub), Coolify se connecte par token personnel d’accès. C’est aussi le cas pour les dépôts privés via SSH classique : vous générez une clef dans Coolify, vous la collez dans les Deploy Keys du dépôt.

Étape 5 — Déployer votre première application

Créez un projet (par exemple « Production »), ajoutez un environnement (production, staging) et cliquez sur « + New Resource » → Application. Sélectionnez votre dépôt Git, la branche, et choisissez le buildpack. Coolify détecte automatiquement les frameworks Node.js, Next.js, Astro, Nuxt, SvelteKit, Laravel, Symfony, Django, Flask, FastAPI, Rails, Go, Rust et propose la bonne configuration par défaut.

Pour une application Next.js typique, le seul réglage à vérifier est le port (par défaut 3000) et les variables d’environnement (DATABASE_URL, NEXT_PUBLIC_*, NEXTAUTH_SECRET). Ajoutez votre nom de domaine personnalisé, activez HTTPS, et cliquez Deploy. Le premier build prend généralement 3 à 8 minutes selon la taille du projet et la puissance du VPS. Pour un guide pas-à-pas spécifique Next.js, voir notre tutoriel déploiement Next.js sur Coolify.

Étape 6 — Bases de données et services managés

L’un des points forts de Coolify est la gestion native des bases de données. En un clic vous pouvez provisionner PostgreSQL (versions 14 à 17), MySQL, MariaDB, MongoDB, Redis, KeyDB, Dragonfly ou ClickHouse. Chaque base reçoit une URL de connexion interne (réseau Docker) que vous pouvez référencer comme variable d’environnement dans vos applications. Cette URL n’est pas exposée à l’extérieur par défaut — vos bases sont uniquement accessibles depuis les applications hébergées sur le même Coolify.

Pour aller plus loin sur la mise en production de PostgreSQL avec Coolify (tuning, sauvegardes, monitoring, réplication), consultez notre guide dédié PostgreSQL Coolify. Si votre application a besoin de plusieurs bases ou d’un pooler comme PgBouncer, Coolify supporte le déploiement Docker Compose custom dans le même projet.

Étape 7 — HTTPS, domaines, redirections

Coolify utilise Traefik comme reverse proxy, ce qui est l’état de l’art en 2026. Vous pouvez ajouter plusieurs domaines à une même application (apex + www, par exemple), forcer la redirection HTTPS, configurer des en-têtes personnalisés (HSTS, CSP, X-Frame-Options) et même router selon le path (/api vers une app, / vers une autre). Les certificats Let’s Encrypt sont renouvelés automatiquement 30 jours avant expiration.

Pour les domaines avec wildcard (*.exemple.com), il faut activer le challenge DNS-01, ce qui demande de configurer une clef API chez votre registrar (Cloudflare, OVH, Gandi, Route 53). C’est un peu plus technique mais documenté pas-à-pas dans la doc officielle. Pratique pour héberger plusieurs sous-domaines clients sur la même instance.

Étape 8 — Backups et restauration

Configurez immédiatement les backups automatiques de vos bases de données — ne reportez jamais cette étape. Coolify supporte les destinations S3 compatibles : AWS S3, Backblaze B2, Wasabi, MinIO auto-hébergé. Pour une PME africaine, je recommande Backblaze B2 (très économique, environ 6 $ par To/mois) ou un MinIO auto-hébergé sur un second VPS pour garder les données dans un environnement que vous maîtrisez.

Notre guide dédié aux backups Coolify avec S3 et MinIO détaille la stratégie 3-2-1, le test de restauration mensuel obligatoire et l’automatisation complète. La règle d’or : un backup non testé n’existe pas. Faites au moins une restauration de validation par mois sur une instance staging.

Étape 9 — Monitoring et alertes

Coolify intègre une vue Logs en direct par application, ainsi que des graphiques basiques de CPU, RAM et trafic. Pour la supervision longue durée et les alertes, déployez Uptime Kuma depuis le marketplace Coolify : c’est un monitoring open-source qui fait du HTTP check, ping, port TCP, certificats SSL, avec notifications email/Discord/Slack/Telegram. En 5 minutes vous avez une page de status publique.

Pour des métriques applicatives plus poussées (latence par endpoint, erreurs 5xx, traces), branchez Plausible Analytics ou Umami pour le côté frontend, et un APM comme OpenTelemetry + Grafana Loki pour le backend. Tout ça se déploie sur le même Coolify.

Adaptation au contexte ouest-africain

Plusieurs spécificités méritent attention quand on déploie Coolify depuis Dakar, Abidjan, Bamako, Ouagadougou ou Cotonou :

• Hébergeurs accessibles : Hetzner (Allemagne, Finlande) offre le meilleur rapport qualité/prix mondial, paiement par carte ou virement SEPA. OVH a un datacenter proche en Europe et accepte le virement bancaire CIMA. Pour le local, ITSkillsCenter et certains opérateurs sénégalais (Maktoob, DigitalRise) proposent des VPS hébergés à Dakar — utiles pour la souveraineté de données et la latence locale.
• Bande passante limitée côté équipe : configurez le déploiement par buildpack en cache pour éviter de retransférer les dépendances à chaque push. Coolify cache automatiquement les layers Docker. Le premier build est lent, les suivants sont rapides.
• Paiement de votre VPS : si votre carte locale est limitée pour les paiements internationaux, utilisez Wise, Wave-Visa virtuelle, ou demandez à un partenaire de payer pour vous en remboursant en FCFA. Hetzner accepte aussi le virement SEPA via une carte CIMA.
• Paiement de vos clients en FCFA via Wave/Orange Money : votre application déployée sur Coolify peut intégrer les API de paiement africaines. Notre guide API Mobile Money 2026 couvre l’intégration Wave, Orange Money, Free Money.
• Surveillance temps réel : Coolify intègre une vue Logs en direct. Pour la supervision longue durée, Uptime Kuma (déployable en un clic depuis le marketplace) suffit pour 95 % des PME.
• Souveraineté des données : si vous gérez des données de santé, scolaires ou financières dans un pays où la loi exige l’hébergement national (Sénégal CDP, Côte d’Ivoire ARTCI), vérifiez avec votre conseil juridique. Un VPS chez un opérateur national peut être nécessaire.

Erreurs fréquentes

Erreur	Cause	Solution
« Could not resolve host » pendant le build	DNS du VPS mal configuré	Vérifiez /etc/resolv.conf, utilisez 1.1.1.1 ou 8.8.8.8
Application en boucle de redémarrage	Port mal exposé ou healthcheck qui échoue	Ajustez le port dans la config et désactivez le healthcheck pour debug
Let’s Encrypt refuse le certificat	DNS non propagé ou rate limit	Vérifiez avec dig que le domaine pointe bien sur le VPS, attendez 1h puis retentez
Out of memory pendant le build Next.js	VPS sous-dimensionné	Passez à 4 Go ou activez 2 Go de swap
Coolify ne démarre plus après reboot	Docker daemon pas auto-démarré	systemctl enable docker
Espace disque saturé	Images Docker orphelines	docker system prune -a (attention en prod)
Backup S3 échoue silencieusement	Credentials expirées ou bucket plein	Vérifier les logs Coolify et tester avec aws s3 ls

Cas d’usage concrets PME africaines

Cas 1 — Agence web Dakar (5 développeurs, 20 sites clients). Un VPS Hetzner CCX23 (4 vCPU, 16 Go RAM, 80 € par mois) avec Coolify héberge les 20 sites WordPress, plus une instance Plausible mutualisée pour le suivi analytics. Backups B2 quotidiens. Coût total ≈ 100 € par mois pour 20 sites au lieu de 200 € minimum sur des hébergeurs managés.

Cas 2 — Startup fintech Abidjan. Application Next.js + API Express + Postgres + Redis + worker Bull, déployée sur Coolify avec un VPS production (Hetzner CX42, 8 vCPU, 16 Go) et un VPS staging (CX22). Déploiements continus depuis GitHub Actions. Backups Postgres toutes les 6 heures vers Backblaze B2. Coût ≈ 50 € par mois.

Cas 3 — Freelance Bamako. Un seul VPS Hetzner CX22 (4 € par mois) avec Coolify héberge son portfolio, le SaaS qu’il construit, deux sites clients, une instance n8n pour automatiser ses tâches. Backups vers MinIO sur un VPS partagé avec un confrère.

Pour aller plus loin

• Coolify vs Dokploy vs CapRover : comparatif honnête 2026
• Déployer Next.js sur Coolify depuis GitHub
• PostgreSQL managé avec Coolify en production
• Backups automatiques Coolify vers S3 et MinIO
• Documentation officielle Coolify : coolify.io/docs
• Repository GitHub : github.com/coollabsio/coolify

FAQ

Coolify est-il vraiment gratuit en production ?

Oui, la version self-hosted est 100 % gratuite et open-source sous licence Apache 2.0. L’équipe propose une version cloud payante (coolify.io) si vous ne voulez pas gérer le serveur, mais le code et les fonctionnalités sont identiques. Vous pouvez héberger autant d’applications, de bases et d’utilisateurs que votre VPS le permet.

Quel VPS minimum pour Coolify ?

Le minimum technique est 2 vCPU / 2 Go RAM, mais vous serez très limité : Coolify lui-même consomme 500-800 Mo en idle, et un build Next.js peut demander 2 Go ponctuellement. Pour héberger 3 à 5 applications avec leurs bases, comptez 4 Go RAM minimum (Hetzner CX22 ou équivalent, environ 4 à 5 € par mois). Pour 10+ applications, passez à 8 Go RAM.

Coolify remplace-t-il Kubernetes ?

Non, Coolify est conçu pour les besoins petits et moyens (PME, freelances, projets indépendants). Pour de la haute disponibilité multi-clusters avec auto-scaling poussé, gardez Kubernetes ou K3s. Pour 90 % des projets africains, Coolify suffit largement et économise des dizaines d’heures de complexité.

Peut-on migrer une app Heroku vers Coolify ?

Oui. Coolify utilise Nixpacks (similaire aux buildpacks Heroku) ou votre Dockerfile existant. La migration consiste essentiellement à pointer Coolify sur votre dépôt Git et recréer les variables d’environnement. La base de données se restaure depuis un dump pg_dump. Comptez 1 à 2 heures par application non triviale.

Coolify est-il sécurisé en production ?

Oui, à condition de suivre les bonnes pratiques : 2FA activée, panel exposé uniquement en HTTPS, pas d’inscription publique, mots de passe forts, mises à jour Coolify régulières (un clic depuis l’interface), bases de données non exposées publiquement, et VPS lui-même durci (UFW, fail2ban, SSH par clef uniquement).

Que faire si mon VPS plante ?

C’est exactement pour ça que les backups S3 hors site sont obligatoires. En cas de crash total, vous reprovisionnez un nouveau VPS, réinstallez Coolify, restaurez les backups Postgres depuis B2, et redéployez les applications depuis Git. Comptez 1 à 3 heures pour un retour en ligne complet selon le nombre d’applications.