PyNextcloud/COOLIFY.md

🚀 Guide de déploiement Coolify

Configuration rapide

1. Variables d'environnement requises

Dans Coolify, ajoutez ces variables d'environnement :

NEXTCLOUD_URL=https://votre-serveur-nextcloud.com
NEXTCLOUD_USERNAME=votre_username
NEXTCLOUD_PASSWORD=votre_password
APP_HOST=0.0.0.0
APP_PORT=8000

2. Configuration du projet

• Build Pack : Dockerfile
• Port : 8000
• Health Check Path : /health
• Health Check Interval : 30s

3. Déploiement automatique

Coolify détectera automatiquement :

• ✅ Dockerfile pour construire l'image
• ✅ docker-compose.yml pour la configuration
• ✅ Health check configuré

4. Branches et CI/CD

• Branche principale : main ou master
• Auto-deploy : Activez le déploiement automatique sur push
• Build automatique : Coolify construira l'image à chaque push

5. Vérification du déploiement

Après le déploiement, testez ces endpoints :

# Health check
curl https://votre-domaine.com/health

# Documentation
https://votre-domaine.com/docs

# Liste des routes
curl https://votre-domaine.com/debug/routes

6. Logs et monitoring

# Dans Coolify, accédez aux logs via l'interface
# Ou utilisez la commande Docker :
docker logs -f <container_name>

Troubleshooting

Le conteneur ne démarre pas

• Vérifiez que toutes les variables d'environnement sont définies
• Consultez les logs du build dans Coolify
• Vérifiez que le port 8000 n'est pas déjà utilisé

Health check échoue

• Attendez 40 secondes (start_period) après le démarrage
• Vérifiez que l'endpoint /health répond
• Consultez les logs de l'application

Erreurs de connexion Nextcloud

• Vérifiez l'URL de votre serveur Nextcloud
• Testez les identifiants manuellement
• Assurez-vous que le serveur Nextcloud est accessible depuis le conteneur

Support

Pour toute question, consultez :

• Documentation Coolify
• Les logs de l'application dans Coolify
• L'endpoint /debug/routes pour vérifier les routes disponibles