Dépannage
D'abord, regarder
docker compose ps # ce qui tourne
docker compose logs --tail 100 # ce qui a échoué
curl http://localhost:8410/health # le backend est-il vivant
En bonne santé : chronicler-postgres, chronicler-ollama et
chronicler-backend démarrés, et chronicler-ollama-pull arrêté — ce
dernier télécharge le modèle puis se termine, c'est normal.
La pile ne démarre pas
POSTGRES_PASSWORD is missing a value
Il n'y a pas de .env à côté du fichier compose, ou il ne contient pas cette
ligne. Compose refuse de démarrer plutôt que d'utiliser une valeur devinable.
printf 'POSTGRES_PASSWORD=%s\nCOMPOSE_PROFILES=cpu\n' "$(openssl rand -hex 24)" > .env
docker compose up -d
.env d'origine.port is already allocated
Autre chose occupe 8410, 11434 ou 5432 — souvent une ancienne pile Chronicler.
docker ps -a | grep chronicler # une ancienne pile ?
Arrêtez l'autre programme, ou déplacez Chronicler :
BACKEND_PORT=8411
Puis pointez l'application vers http://localhost:8411.
Cannot connect to the Docker daemon
Docker n'est pas démarré. Lancez Docker Desktop et attendez qu'il soit prêt.
La pile tourne mais rien ne répond
Ollama did not come up ... within 2 minutes
COMPOSE_PROFILES est absent ou mal orthographié : aucun runtime de modèle n'a
démarré. C'est la panne d'auto-hébergement la plus fréquente.
grep COMPOSE_PROFILES .env # doit valoir cpu, nvidia ou amd
Corrigez, puis docker compose up -d. Vérifiez avec docker compose ps que
ollama-cpu, ollama-nvidia ou ollama-amd tourne.
Les conversations échouent, le journal parle de modèle introuvable
Le téléchargement du modèle n'est pas allé au bout. Observez :
docker compose logs ollama-pull
docker exec chronicler-ollama ollama list
Si la liste est vide, téléchargez à la main :
docker exec chronicler-ollama ollama pull gemma4:e2b
Tout renvoie 403, ou les documents refusent de s'ouvrir
Licence absente ou périmée. Admin → Licence :
- Aucune licence activée — collez votre clé.
- Active, mais l'application reste bloquée — regardez Dernière
vérification. Si elle date de plus de 72 heures, le serveur n'atteint pas
api.chroniclerlm.com. Rétablissez le HTTPS sortant ; tout revient seul.
Voir Licence.
Ça marche, mais c'est pénible
La première réponse prend des minutes
Normal sur processeur : le modèle doit se charger. Gardez-le chargé :
OLLAMA_KEEP_ALIVE=-1
Toutes les réponses prennent des minutes
Soit vous êtes sur le processeur alors qu'il y a une carte graphique, soit le modèle est trop gros pour la machine.
docker compose ps # ollama-cpu, ou ollama-nvidia ?
nvidia-smi # la mémoire bouge-t-elle pendant la génération ?
docker stats --no-stream # quelque chose est-il collé à sa limite ?
Voir Accélération GPU et Performances et mémoire.
Les conteneurs redémarrent en boucle
Mémoire insuffisante. docker stats montre ce qui se fait tuer ; augmentez la
mémoire de Docker ou choisissez un modèle plus petit. En dessous de 4 Gio
disponibles pour Docker, le backend ne peut pas survivre au chargement d'un
modèle.
L'application n'atteint pas le serveur
Vérifier le serveur lui-même
curl http://localhost:8410/health
En échec localement, le problème vient de la pile : voir plus haut.
Vérifier depuis l'autre poste
curl http://192.168.1.50:8410/health
En échec, c'est le pare-feu ou la mauvaise adresse. Sous Windows, Docker Desktop et le pare-feu Windows doivent tous deux l'autoriser.
Vérifier l'adresse dans l'application
Paramètres → Connexion : mode Local, URL complète avec http:// et le
port. 192.168.1.50 seul ne marchera pas ; http://192.168.1.50:8410 oui.
Des documents restent en traitement
Les gros fichiers scannés sont lents — l'OCR est la partie coûteuse, et sur processeur un scan de 200 pages peut prendre très longtemps.
docker compose logs backend --tail 100
docker stats --no-stream
Si c'est vraiment bloqué et non lent, redémarrez le backend
(docker compose restart backend) et réimportez. Si cela concerne tous les
documents, vous êtes à court d'espace disque ou au bout de l'allocation définie
dans Admin → Paramètres.
Le disque est plein
docker system df -v
Coupables habituels : les anciennes images après plusieurs mises à jour, et les anciens modèles.
docker image prune -a # images inutilisées — sans risque
docker exec chronicler-ollama ollama list # modèles devenus inutiles
docker volume prune ni docker compose down -v : cela
supprime postgres_data et backend_uploads, c'est-à-dire toute votre
installation.J'ai perdu le mot de passe administrateur
Il n'y a pas de récupération de l'extérieur : le serveur n'a jamais eu de mot de passe consultable. Un autre administrateur peut le réinitialiser depuis Admin → Utilisateurs. S'il n'y a qu'un administrateur et qu'il est bloqué, restaurez une sauvegarde antérieure au changement, ou repartez d'une base vide — c'est pourquoi un second compte administrateur est utile.
Tout recommencer
Supprime tout :
docker compose down -v
docker compose up -d
Faites une sauvegarde d'abord si vous tenez à quelque chose.
Rassembler des informations pour le support
docker compose ps > support.txt
docker compose logs --tail 500 >> support.txt
docker info --format "{{.MemTotal}} {{.KernelVersion}}" >> support.txt
docker compose config >> support.txt
docker compose config affiche le mot de passe de votre base. Retirez-le avant
d'envoyer le fichier à qui que ce soit.