Auto-hébergement
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. |
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 | 5m | 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
# 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. |
Terminal
docker volume ls | grep chronicler
docker system df -v # l'espace occupé par chacun
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
Terminal
docker compose config # le fichier résolu, toutes variables développées
docker compose ps # ce qui tourne
docker compose logs backend # ce que le backend en pense
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.