Configuration et accès
Référence de configuration
Tous les réglages modifiables, où ils vivent, et ce qui est volontairement figé.
Où vivent les réglages
| Où | Quoi | Prise en compte |
|---|---|---|
.env à côté de docker-compose.yml | Mot de passe, profil GPU, ports, versions, réglages mémoire | Après docker compose up -d |
| Console d'administration | Modèle, lieu d'indexation, allocation disque, sauvegardes, licence, mises à jour | Immédiate |
| Figé dans l'image | Mode organisation, politique d'inscription, application de la licence, modèle d'indexation, URL internes | Non modifiable |
Le fichier
.env contient le mot de passe de votre base. C'est la seule clé du
volume postgres_data : sauvegardez-le, et ne le régénérez jamais sur une
installation en service.Obligatoires
| Variable | Description |
|---|---|
POSTGRES_PASSWORD | Mot de passe de la base. Aucune valeur par défaut. Compose refuse de démarrer sans. |
COMPOSE_PROFILES | Runtime du modèle : cpu, nvidia ou amd. Non défini = aucun runtime ne démarre. |
Matériel
| Variable | Description |
|---|---|
CHRONICLER_GPU_VRAM_GB | VRAM de la carte graphique, en Go entiers. Renseignée sur le profil nvidia uniquement. Le conteneur backend n'a aucun accès au GPU, donc sans cette clé Admin → Modèle déclare l'absence de GPU et grise les modèles de cette catégorie. Le script de détection et l'application l'écrivent tous les deux. |
Versions
| Variable | Défaut | Description |
|---|---|---|
CHRONICLER_VERSION | latest | Version de l'image backend. Fixez-la (ex. 1.0.9) pour rendre les mises à jour délibérées. |
OLLAMA_VERSION | 0.32.4 | Version de l'image Ollama. |
Le fichier compose fourni par l'application ou par la version publiée utilise
CHRONICLER_VERSION. Si vous partez du docker/docker-compose.yml du dépôt, les
équivalents sont IMAGE_TAG et IMAGE_NAMESPACE, et OLLAMA_GENERATION_MODEL
choisit le modèle pré-téléchargé.Ports
| Variable | Défaut | Description |
|---|---|---|
BACKEND_PORT | 8410 | Là où l'application se connecte. À changer si 8410 est pris. |
OLLAMA_PORT | 11434 | Runtime du modèle. N'a besoin d'être joignable que depuis la pile. |
POSTGRES_PORT | 5432 | Base de données. Liée à 127.0.0.1 - injoignable depuis le réseau, par conception. |
Mémoire et performances
Explications complètes sur Performances et mémoire.
| Variable | Défaut | Description |
|---|---|---|
OLLAMA_KEEP_ALIVE | 96h | Durée de résidence du modèle en mémoire. -1 = indéfiniment. |
OLLAMA_NUM_PARALLEL | automatique | Requêtes simultanées par modèle. Multiplie la mémoire de contexte. |
OLLAMA_MAX_LOADED_MODELS | automatique | Modèles résidents simultanément. |
OLLAMA_CONTEXT_LENGTH | 16384 | Contexte par défaut des autres clients. Ne change pas celui des conversations. |
POSTGRES_SHARED_BUFFERS | 128MB | Cache de la base. |
POSTGRES_WORK_MEM | 4MB | Mémoire par tri. |
Une variable que vous omettez n'est pas transmise du tout au conteneur : la valeur par défaut du runtime s'applique. C'est voulu - impossible de définir accidentellement une valeur vide.
Un exemple complet
.env
# Obligatoire
POSTGRES_PASSWORD=8f3c1d7a9b2e4c6f0a5d8e1b3c7f9a2d4e6b8c0f
COMPOSE_PROFILES=nvidia
# Pour que la console connaisse la taille de la carte
CHRONICLER_GPU_VRAM_GB=24
# Version fixée pour des mises à jour délibérées
CHRONICLER_VERSION=1.0.9
# Mémoire : serveur dédié, modèle toujours chaud, quatre personnes
OLLAMA_KEEP_ALIVE=-1
OLLAMA_NUM_PARALLEL=4
POSTGRES_SHARED_BUFFERS=2GB
POSTGRES_WORK_MEM=16MB
Volumes
Ces trois volumes sont votre installation. Le reste est jetable.
| Volume | Contenu |
|---|---|
postgres_data | Base : comptes, documents, index de recherche. |
backend_uploads | Fichiers importés, sauvegardes, clé de signature et identifiant d'installation. |
ollama_data | Modèles téléchargés. Volumineux, et retéléchargeables. |
PowerShell
docker volume ls | Select-String "chronicler"
docker system df -v
Shell Linux
docker volume ls | grep chronicler
docker system df -v
docker compose down -v supprime ces volumes et tout ce qu'ils contiennent. Un
docker compose down simple, non. Il n'y a pas de retour en arrière.Facultatif : un dossier de sauvegarde externe
Pour que les sauvegardes planifiées soient copiées hors de Docker, montez un
dossier de la machine hôte dans le conteneur backend. Dans votre
docker-compose.yml, sous le service backend :
docker-compose.yml
volumes:
- backend_uploads:/app/uploads
- /mnt/nas/chronicler-backups:/mnt/backups
Saisissez ensuite /mnt/backups comme dossier externe dans Admin →
Sauvegardes. Détails :
Sauvegardes et restauration.
Ce que vous ne pouvez pas changer, et pourquoi
| Figé | Pourquoi |
|---|---|
| Mode organisation unique | Un serveur auto-hébergé sert une organisation. C'est ce qui rend comptes, partages et licence prévisibles. |
| Pas d'inscription libre | Les comptes sont créés par un administrateur, jamais en libre-service. |
| Application de la licence | Toujours active. Le fichier compose ne peut pas la désactiver. |
| URL du service de licence | Fixe, et les réponses sont signées : rediriger la vérification ailleurs ne fonctionne pas. |
| Modèle d'indexation | En changer invaliderait tous les index existants. Intégré à l'image pour ne jamais manquer. |
| URL internes | Le backend joint la base et le runtime via le réseau privé de la pile. |
Les points liés à la sécurité sont appliqués dans l'image, pas dans le fichier compose : modifier ce dernier ne peut pas les désactiver.
Voir clairement sa configuration
PowerShell
docker compose config
docker compose ps
docker compose logs backend
Shell Linux
docker compose config
docker compose ps
docker compose logs backend
docker compose config est la réponse honnête à « est-ce que mon .env a bien
été pris en compte » : il montre les valeurs résolues, pas celles que vous
pensiez avoir écrites.