Skip to main content

Dépannage

Commandes de diagnostic​

# État de tous les services
docker compose -f docker-compose.onprem.yml ps

# Logs en temps réel
docker compose -f docker-compose.onprem.yml logs -f

# Logs d'un service précis
docker compose -f docker-compose.onprem.yml logs api --tail=100
docker compose -f docker-compose.onprem.yml logs celery --tail=50

# Vérifier l'état de la DB
docker exec aiterava_onprem_db pg_isready -U aiterava

# Tester la connexion Redis
docker exec aiterava_onprem_redis redis-cli PING

Problèmes fréquents​

L'API ne démarre pas​

Symptôme : aiterava_onprem_api s'arrête juste après le démarrage.

docker logs aiterava_onprem_api --tail=50

Causes courantes :

  • SECRET_KEY manquante ou trop courte dans .env
  • ALLOWED_HOSTS ne contient pas votre domaine
  • La DB PostgreSQL n'est pas encore prête (attendre 10-15s après up -d)
# Forcer un redémarrage après correction du .env
docker compose -f docker-compose.onprem.yml up -d --force-recreate api

Erreur 502 Bad Gateway (Nginx)​

Le service API ou Frontend ne répond pas.

# Vérifier que les ports internes sont en écoute
docker compose -f docker-compose.onprem.yml ps | grep -E "api|frontend"
# Doit afficher "running" et les ports mappés

# Tester directement sans Nginx
curl http://localhost:8000/api/v1/health/

Mise à jour bloquée en état "running"​

Si une mise à jour reste bloquée (crash du processus de mise à jour) :

# Effacer manuellement le statut en Redis
docker exec aiterava_onprem_redis redis-cli DEL "aiterava:system:update_status"

Rechargez la page — le statut repassera à "idle".

Synchronisation hybride échoue​

docker compose -f docker-compose.onprem.yml logs celery --tail=50 | grep -i sync

Vérifications :

  • CLOUD_API_KEY correcte et non expirée
  • CLOUD_TENANT_SLUG correspond au slug de votre tenant cloud
  • Accès sortant HTTPS vers api.aiterava.com
# Test de connectivité cloud depuis le container
docker exec aiterava_onprem_api curl -s \
  -H "Authorization: Bearer $CLOUD_API_KEY" \
  https://api.aiterava.com/api/v1/health/

Registry inaccessible lors d'une mise à jour​

# Tester la connexion au registry
docker exec aiterava_onprem_api curl -s \
  -H "Authorization: Basic $(echo -n 'USER:PASS' | base64)" \
  https://registry.aiterava.com/v2/
# Doit retourner {}

Si le registry est inaccessible, la mise à jour ne peut pas télécharger les nouvelles images. Vérifiez vos identifiants registry dans .env.

Certificat SSL expiré​

sudo certbot renew --dry-run
sudo certbot renew
sudo nginx -s reload

Contacter le support​

Si le problème persiste, envoyez les informations suivantes à support@aiterraxis.com :

# Résumé de l'état du système
docker compose -f docker-compose.onprem.yml ps
docker compose -f docker-compose.onprem.yml logs --tail=100 2>&1 | gzip > logs_support.gz
curl -s https://hotel.votredomaine.com/api/v1/health/