Coolify
Vérifications et dépannage
Liste de vérification après un déploiement et pannes Coolify courantes.
Après chaque mise en ligne
Section intitulée « Après chaque mise en ligne »Un build réussi ne prouve pas que le site fonctionne. Vérifier sur le domaine déployé :
- Connexion au back-office, Santé du site au vert
- Accueil, une page et un article s’affichent, dans chaque langue
- Images et documents s’ouvrent
- Une modification publiée apparaît tout de suite sur le site
- La live preview fonctionne
- Formulaire envoyé : mail reçu et demande visible dans le back-office
- Une adresse inexistante affiche la page 404 du site
-
/sitemap.xmlet/robots.txtrépondent - Indexation :
PUBLIC_ALLOW_INDEXING=trueuniquement sur le domaine final - CAPTCHA : vraies clés sur le domaine final
- Sauvegarde planifiée active
Déploiement
Section intitulée « Déploiement »| Problème | Solution |
|---|---|
URL PostgreSQL requise, Serveur SMTP requis… |
Renseigner la variable nommée dans l’erreur |
port already allocated sur la base |
Choisir un autre port dans Public access |
network coolify … could not be found |
Vérifier le nom du réseau de destination |
| Conflit de noms entre projets | Donner un COMPOSE_PROJECT_NAME unique |
| Disque plein | Nettoyage du disque |
Back-office
Section intitulée « Back-office »| Problème | Solution |
|---|---|
unhealthy, Invalid URL |
Ajouter https:// aux variables PUBLIC_*_URL, puis rebuilder |
unhealthy, base injoignable |
URL interne de la base et Predefined network activé |
| Erreur de table ou de colonne | bun run migrate, puis bun run schema:check |
| Formulaire de premier compte refusé | Normal en production : bun run admin:create |
| Clés Brevo ou CAPTCHA illisibles | PAYLOAD_SECRET a changé : remettre l’ancien ou ressaisir les clés |
| Tâches de fond en retard | Lire les journaux du CMS |
Un conteneur unhealthy ne redémarre pas seul.
| Problème | Solution |
|---|---|
| Erreur 502 | Vérifier le domaine et le port interne du service |
| Page 503 partout | Couper le mode maintenance : Configuration du site → Annonce et maintenance |
| Page 503 sur certaines pages | CMS injoignable : vérifier /api/health du site |
Image /media/… en 500 |
Copier les fichiers sur le volume : ceux envoyés en local ne suivent pas |
| Ancienne URL dans le HTML | Relancer un build |
| Page publiée non mise à jour | SITE_SECRET doit être identique côté CMS et site |
| Live preview vide | Utiliser deux sous-domaines du même site, en HTTPS |
| CAPTCHA toujours accepté | Normal sur *.lnx-coo-1-1.celuga.net : clés de test |
| Erreur | À vérifier |
|---|---|
535, EAUTH |
Identifiants du compte |
550 5.1.1, User unknown |
Adresse du destinataire |
Relay access denied |
Expéditeur autorisé, IP de sortie du serveur |
| Délai dépassé, DNS | Hôte, port, pare-feu |
| Erreur de certificat, STARTTLS | Certificat, port 587 ou 465 |
| Notification en échec | Corriger, puis Relancer la notification |
Un mail accepté par Brevo peut encore être rejeté : consulter les journaux Brevo.