Déploiement en échec
- Ouvrez le projet → onglet Logs.
- Identifiez l’étape en échec :
- clone : dépôt inaccessible, mauvaises permissions Git, dépôt trop volumineux.
- dockerfile : technologie non détectée — vérifiez la structure du dépôt.
- upload : espace disque insuffisant sur le serveur.
- build : erreur de compilation, dépendance manquante, image introuvable sur Docker Hub.
- deploy : port déjà occupé, variable manquante, conflit de conteneur.
- healthcheck : l’application ne répond pas dans les 60 secondes.
- Paylood affiche un diagnostic automatique basé sur les logs (dernières lignes).
Astuce
Relancez avec l’option sans cache si le problème ressemble à un cache Docker corrompu.
L’application tourne mais renvoie une erreur
| Symptôme | Cause probable | Vérification |
|---|---|---|
| 502 / 504 | Healthcheck passé mais app lente | Consultez la console (top, logs) |
| Base de données non connectée | Mauvaises variables | Vérifiez l’onglet Variables puis redéployez |
| Page blanche frontend | Build sans VITE_* injectée | Vérifiez les variables de build |
| Certificat invalide | Domaine pas encore vérifié | Vérifiez le statut du domaine |
Le webhook Git ne déclenche rien
- Auto-deploy activé ? (Settings du projet)
- Webhook présent chez le fournisseur ? (Réglages du dépôt → Webhooks)
- La branche du push correspond-elle à l’environnement ?
- Le webhook pointe-t-il vers une URL publique ?
Connexion SSH impossible
- Timeout : port 22 fermé, IP erronée, pare-feu.
- Permission denied : mauvais utilisateur ou mot de passe.
- Host key rejected : réinitialisez le serveur dans Paylood.
Un service ne démarre pas
- Vérifiez la version de l’image (nom + tag).
- Vérifiez que le port n’est pas déjà utilisé sur le serveur.
- Consultez les logs du conteneur via la Console (
docker ps,docker logs <id>). - Vérifiez les variables d’environnement du service.
DNS / domaine en échec de vérification
- L’enregistrement A pointe-t-il vers l’IP de votre VPS ?
- La propagation est-elle terminée ? (utilisez
digou un outil en ligne) - Paylood doit être joignable sur le domaine (pas de CNAME externe).
Sauvegarde en échec
- Conteneur de base de données actif sur le serveur ?
- Espace disque suffisant ?
- Variables d’accès à la base correctes ?
Console sans réponse
- Le serveur est-il actif ?
- Le projet a-t-il été déployé au moins une fois ?
- La connexion réseau est-elle stable ? Rechargez la page.
Signaler un bug
Ouvrez une issue sur le dépôt GitHub avec :
- Les étapes pour reproduire.
- Les logs concernés.
- La version / commit de l’installation.
La plupart des problèmes se résolvent par un redéploiement après correction des variables ou du dépôt. N’hésitez pas à utiliser la Console pour diagnostiquer en direct.