Tous les articles

Du code à la production en 10 minutes avec Coolify

Ross Hill · 15 avril 2026 · Mis à jour: 16 avril 2026

Vous avez une application qui fonctionne sur votre machine. Un frontend Next.js, une API Python, un service Go. Ça tourne en local. Maintenant, il vous faut un vrai URL sur Internet, avec SSL et un processus de déploiement qui ne demande pas un diplôme en ingénierie système.

Coolify (en anglais) est une plateforme de déploiement à code source ouvert qui gère le pipeline de build, déploiement et hébergement. Pensez-y comme une alternative auto-hébergée à Heroku ou Railway. Connectez un dépôt Git, configurez le build et déployez. Voici le processus complet.

Étape 1 : connectez votre dépôt

Dans Coolify, configurez une source Git sous Sources dans la barre latérale. Coolify prend en charge GitHub, GitLab, Bitbucket et d'autres fournisseurs. Autorisez l'application, sélectionnez les dépôts à partager, et c'est connecté. C'est une configuration unique. Chaque futur projet pourra utiliser la même source.

Contenu de la page Sources de Coolify montrant une source GitHub connectée avec un bouton d'ajout
La page Sources après la connexion d'un fournisseur Git. Configuration unique, ensuite chaque projet peut l'utiliser.

Étape 2 : créez un projet et une application

Allez dans Projets, créez-en un nouveau, puis ajoutez une nouvelle ressource. Sélectionnez votre dépôt et votre branche. Coolify vous demandera comment vous souhaitez construire l'application.

Gros plan sur six options de déploiement réparties en colonnes Git et Docker avec descriptions
Choisissez entre les options de dépôt public et privé lors de l'ajout d'une nouvelle ressource.

Étape 3 : choisissez votre méthode de build

Vous avez deux options : Dockerfile ou Nixpacks.

Dockerfile est le choix fiable. Vous contrôlez le build, les dépendances, l'exécution. Si votre dépôt a déjà un Dockerfile, sélectionnez-le et c'est terminé.

Nixpacks détecte automatiquement votre langage et votre framework. Ça fonctionne bien pour les projets standards en Node.js, Python, Go et Ruby. Pour tout ce qui implique un processus de build personnalisé ou un monorepo, Dockerfile est plus prévisible.

Dans les deux cas, renseignez le champ « Ports Exposes » pour qu'il corresponde au port sur lequel votre application écoute. Une application Next.js utilise le port 3000. Une application Flask utilise le port 5000. Si ça ne correspond pas, le déploiement réussira mais l'application ne répondra pas.

Gros plan sur la section Réseau montrant Ports Exposes configuré sur 3000, les mappages de ports et les alias réseau
Renseignez Ports Exposes pour qu'il corresponde au port sur lequel votre application écoute.

Étape 4 : déployez et testez

Lancez le déploiement. Coolify récupère votre code, construit l'image et démarre le conteneur. Vous pouvez suivre les journaux en temps réel.

Gros plan sur la sortie du journal de déploiement montrant les étapes de build horodatées, la construction d'image Docker et la mise à jour progressive du conteneur
Les journaux horodatés montrent exactement ce qui se passe à chaque étape du build et du déploiement.

Une fois terminé, vérifiez l'URL temporaire sous le menu déroulant « Links » en haut de la page de l'application. Si vous voyez votre application, ça fonctionne. Si vous voyez un 502, revérifiez la configuration du port.

Gros plan sur le menu déroulant Links ouvert montrant un URL temporaire sslip.io avant la configuration du domaine personnalisé
Le menu déroulant Links affiche l'URL temporaire de votre application. Pas de DNS nécessaire.

À ce stade, votre application est en ligne. Pas de configuration de domaine requise, pas de DNS, pas de certificats. Juste un URL fonctionnel que vous pouvez partager ou utiliser pour vos tests.

Étape 5 : ajoutez un domaine personnalisé

Quand vous êtes prêt pour un vrai URL, deux choses sont nécessaires.

D'abord, pointez le DNS de votre domaine vers votre serveur. Créez un enregistrement A avec l'adresse IP de votre serveur. Si vous êtes sur MapleDeploy, vous la trouverez dans votre tableau de bord ou dans Coolify sous les paramètres du serveur.

Ensuite, configurez le champ « Domains » dans votre application Coolify avec votre ou vos domaines complets :

https://example.com,https://www.example.com
Gros plan sur la configuration générale de l'application montrant le nom, le Build Pack configuré sur Dockerfile, le champ Domaines et le paramètre de direction
Entrez vos domaines personnalisés dans le champ Domains au format URL complet.

Redéployez, et Coolify provisionnera automatiquement un certificat SSL via Let's Encrypt. Laissez quelques minutes au DNS pour se propager, et votre application est en ligne sur votre propre domaine avec HTTPS.

Pièges courants

Le mauvais port est le problème le plus fréquent. Votre application écoute sur le port 8080, Coolify attend le port 3000. Le déploiement semble réussi mais rien ne charge. Vérifiez toujours que « Ports Exposes » correspond au port réel de votre application.

Écouter sur localhost empêche les applications conteneurisées de fonctionner. Votre application doit écouter sur 0.0.0.0, pas 127.0.0.1. C'est un fondamental du réseau Docker, mais ça surprend les gens qui n'ont jamais conteneurisé d'application.

Variables d'environnement au build vs. à l'exécution. Par défaut, Coolify injecte les variables d'environnement à l'exécution. Si votre framework en a besoin au build (comme les variables NEXT_PUBLIC_ dans Next.js), activez « Build Variable » pour ces variables spécifiques.

Échecs de détection Nixpacks. Si Nixpacks n'arrive pas à comprendre votre projet, passez à un Dockerfile. Vous pouvez générer un point de départ en exécutant nixpacks build . --out . localement, ce qui sauvegarde le Dockerfile généré dans votre répertoire de projet. Ajustez-le ensuite à vos besoins.

Pourquoi Dockerfile plutôt que Nixpacks?

Nixpacks est pratique. Pour un projet standard avec un package.json ou un requirements.txt clair, ça fonctionne sans configuration. Mais la commodité a ses limites.

Les Dockerfiles sont explicites. Vous contrôlez l'image de base, les étapes de build, l'exécution. Quand quelque chose casse, le Dockerfile vous dit exactement ce qui s'est passé. Avec Nixpacks, vous déboguez un plan de build auto-généré que vous n'avez pas écrit.

Pour les charges de travail en production, Dockerfile l'emporte sur la prévisibilité. Pour les prototypes rapides, Nixpacks fait gagner du temps. Utilisez celui qui correspond à la situation.

MapleDeploy dans tout ça

Coolify est un logiciel libre. Vous pouvez l'installer sur n'importe quel VPS et tout gérer vous-même. Ou vous pouvez éviter entièrement l'administration serveur.

MapleDeploy vous offre une instance Coolify entièrement gérée sur infrastructure canadienne à Toronto. Nous gérons la machine virtuelle, les mises à jour du système d'exploitation, les correctifs de sécurité et la surveillance. Vous obtenez la plateforme de déploiement sans le travail d'exploitation.

Chaque serveur est une machine virtuelle dédiée. Pas d'infrastructure partagée, pas de voisins bruyants. Les forfaits commencent à 45 $ CAD/mois avec un essai gratuit de 30 jours. Connectez votre dépôt et déployez.

Pour le guide complet incluant le provisionnement du serveur et le dépannage, consultez notre documentation premiers pas.

Déployez votre première application

Essai gratuit de 30 jours. Poussez votre dépôt, obtenez un URL en ligne. Forfaits à partir de 45 $ CAD/mois.