Problèmes courants
Solutions aux problèmes fréquents d'installation et d'utilisation.
TODO : messages d'erreur exacts à compléter avec ceux du backend.
Le conteneur s'arrête au démarrage
Cause probable : une variable obligatoire manque ou est invalide.
Solution : lisez docker compose logs backend et comparez avec la référence des variables.
Le port est déjà utilisé
Solution : modifiez UNIFAM_APP_PORT ou arrêtez le service qui occupe le port.
Impossible de se connecter
- Vérifiez que
UNIFAM_APP_URLcorrespond à l'adresse utilisée dans le navigateur. - En Standalone, vérifiez
UNIFAM_STANDALONE_EMAILetUNIFAM_STANDALONE_PASSWORD. - Derrière un reverse proxy, vérifiez le HTTPS et les en-têtes transmis.
Les sessions expirent trop vite ou se perdent
Vérifiez UNIFAM_AUTH_SECRET : s'il change entre deux démarrages, toutes les sessions sont invalidées.
L'application est en place mais l'API ne répond pas
Testez /api/v1/health. En cas d'échec, vérifiez la connexion à la base de données (UNIFAM_DB_URL).
Après une mise à jour, l'application ne démarre plus
Consultez le changelog, puis suivez la procédure de retour arrière dans Mise à jour.
L'OCR est lent ou échoue
L'OCR s'exécute localement et demande des ressources. Vérifiez la mémoire disponible et la configuration UNIFAM_OCR_*.
L'import depuis Standalone échoue
Vérifiez que l'archive vient de Export to Suite et que les versions du module et de la Suite sont compatibles.