Déployer votre première application

Ce guide commence une fois que votre serveur MapleDeploy est prêt. Si vous n'avez pas encore créé de serveur, commencez par Créer votre serveur.

À la fin, vous aurez une application en ligne sur votre serveur MapleDeploy avec Coolify.

Ce dont vous aurez besoin

Un dépôt Git hébergé sur GitHub, GitLab, Bitbucket, Gitea ou un autre hébergeur Git.
Un Dockerfile dans votre dépôt, ou un projet que Nixpacks peut détecter.
Le port sur lequel votre application écoute, par exemple 3000, 5000 ou 8080.

GitHub offre l'intégration Coolify la plus complète. Pour les autres fournisseurs Git, les dépôts publics peuvent utiliser Public Repository et les dépôts privés utilisent des clés de déploiement.

Étape 1 : ouvrez Coolify

Connectez-vous au tableau de bord MapleDeploy, ouvrez votre serveur, puis sélectionnez le lien vers le tableau de bord Coolify.

Gros plan sur les détails du serveur montrant le forfait Pro, la région Toronto, l'adresse IP et le lien Coolify — Ouvrez Coolify depuis la page de détails de votre serveur.

Étape 2 : connectez votre fournisseur Git

Si votre code est sur GitHub, commencez par là. Dans Coolify, allez dans Sources et ajoutez une application GitHub. GitHub vous demandera quels dépôts l'application peut lire.

Une fois connecté, Coolify peut récupérer ces dépôts et créer des webhooks pour déployer automatiquement lorsque vous poussez vers la branche sélectionnée.

Contenu de la page Sources de Coolify montrant une source GitHub connectée avec un bouton d'ajout — Les sources Git connectées peuvent être réutilisées pour vos prochaines applications.

Pour GitLab, Bitbucket, Gitea et les autres fournisseurs Git, les dépôts publics peuvent utiliser Public Repository. Pour les dépôts privés, choisissez Private Repository (Deploy Key). Coolify génère une clé de déploiement publique. Ajoutez cette clé dans les paramètres de votre dépôt avec un accès en lecture.

Pour GitLab, Bitbucket et Gitea, utilisez la section Manual Git Webhooks dans Coolify, définissez le secret de webhook correspondant et configurez les événements de push chez votre fournisseur Git. Pour les autres fournisseurs Git, utilisez le webhook de déploiement avec authentification et un jeton d'API Coolify dans le système de workflow ou de webhooks de votre fournisseur.

Étape 3 : créez l'application

Dans Coolify, créez un projet. Les projets regroupent des ressources liées.

Dans le projet, choisissez Add New Resource, puis sélectionnez le type de dépôt :

Public Repository pour un dépôt public.
Private Repository (GitHub App) pour un dépôt connecté par GitHub.
Private Repository (Deploy Key) pour un dépôt privé chez n'importe quel fournisseur Git.

Sélectionnez le dépôt et la branche pour continuer.

Gros plan sur six options de déploiement réparties en colonnes Git et Docker avec descriptions — Choisissez le type de dépôt qui correspond à votre configuration Git.

Étape 4 : configurez le build

Coolify doit savoir comment construire votre application et vers quel port router le trafic.

Pack de build

Si votre dépôt contient un Dockerfile, sélectionnez Dockerfile. C'est l'option la plus prévisible, car votre dépôt contrôle le build.

Si le Dockerfile n'est pas à la racine du dépôt, indiquez son chemin depuis le répertoire de base de l'application dans Dockerfile Location, par exemple /docker/Dockerfile.

Si vous n'avez pas de Dockerfile, sélectionnez Nixpacks. Nixpacks détecte automatiquement les types de projets courants. Pour les monorepos ou les builds inhabituels, utilisez un Dockerfile.

Port exposé

Dans la section Network, définissez Ports Exposes avec le port sur lequel votre application écoute :

Node.js Express ou Next.js : 3000
Python Flask : 5000
Serveur HTTP Go : 8080

Ce port doit correspondre exactement à votre application. Si le port est incorrect, le conteneur peut démarrer, mais l'application ne sera pas accessible.

Gros plan sur la section Réseau montrant Ports Exposes configuré sur 3000, les mappages de ports et les alias réseau — Définissez Ports Exposes avec le port sur lequel votre application écoute.

Étape 5 : déployez

Sélectionnez Deploy. Coolify récupère votre code, construit l'image, démarre le conteneur et affiche les journaux pendant le déploiement.

Une fois le déploiement terminé, ouvrez le menu Links en haut de la page de l'application. Coolify vous donne une URL temporaire qui fonctionne immédiatement.

Gros plan sur le menu déroulant Links ouvert montrant un URL temporaire sslip.io avant la configuration du domaine personnalisé — L'URL temporaire est utile pour vérifier l'application avant d'ajouter un domaine personnalisé.

Étape 6 : vérifiez l'application

Ouvrez l'URL temporaire. Si l'application charge, le déploiement fonctionne.

Si elle ne charge pas, vérifiez d'abord les causes les plus courantes :

Erreurs de build : lisez les journaux de build, puis corrigez les dépendances manquantes ou les commandes en échec.
Mauvais port : définissez Ports Exposes avec le port exact utilisé par votre application.
Variables d'environnement manquantes : ajoutez les variables requises dans Environment Variables, puis redéployez.
Écoute locale seulement : faites écouter l'application sur 0.0.0.0, et pas seulement sur 127.0.0.1 ou localhost.

Prochaines étapes

Pour utiliser une URL de production, suivez Domaines personnalisés.

Pour les bases de données, configurez les sauvegardes avant d'y stocker des données importantes. Consultez le guide des sauvegardes.