Chronicler
Auto-hébergement

Installation manuelle

Installer la pile depuis un terminal — la voie des serveurs sans interface graphique.

À utiliser quand le serveur n'a pas de bureau — un VPS, un NAS, une machine en baie — ou simplement quand vous préférez voir ce que vous exécutez.

Créer un dossier pour l'installation

Tout y vit : le fichier compose, le .env, et par extension votre base de données. Choisissez un emplacement durable.

Terminal
mkdir -p /opt/chronicler && cd /opt/chronicler

Télécharger le fichier compose

Terminal
curl -L -o docker-compose.yml \
  https://github.com/ChroniclerLM/Releases/releases/latest/download/docker-compose.yml

Écrire le .env

Deux valeurs sont obligatoires : un mot de passe de base de données, et le runtime à utiliser pour le modèle.

Terminal
printf 'POSTGRES_PASSWORD=%s\nCOMPOSE_PROFILES=cpu\n' "$(openssl rand -hex 24)" > .env
Aucun mot de passe par défaut n'est livré, volontairement : il rendrait toutes les installations de la planète devinables à l'identique. Compose refuse de démarrer sans, et le changer après le premier démarrage vous coupe l'accès à votre propre base. Sauvegardez ce fichier avec vos autres secrets.

Choisir le bon runtime

COMPOSE_PROFILES décide quel conteneur Ollama démarre : cpu, nvidia ou amd. cpu fonctionne toujours. Si la machine a une carte graphique, laissez le script de détection choisir :

Terminal
curl -L -o detect-hardware.sh \
  https://github.com/ChroniclerLM/Releases/releases/latest/download/detect-hardware.sh
chmod +x detect-hardware.sh
./detect-hardware.sh

Il teste la machine, écrit le bon COMPOSE_PROFILES dans le .env et suggère un modèle adapté. Détails et solutions manuelles : Accélération GPU.

Si COMPOSE_PROFILES est totalement absent, aucun runtime de modèle ne démarre. La pile monte mais ne peut répondre à rien, et docker compose logs ollama-pull le dira au bout de deux minutes.

Démarrer

Terminal
docker compose up -d
docker compose logs -f

Le premier démarrage télécharge plusieurs gigaoctets. Quand chronicler-backend annonce écouter sur 8410, c'est prêt. L'arrêt de chronicler-ollama-pull est normal : il télécharge le modèle puis se termine.

Vérifiez avec :

Terminal
docker compose ps
curl http://localhost:8410/health

Connecter l'application et s'approprier le serveur

Depuis n'importe quel poste du réseau, ouvrez Chronicler → Paramètres → Connexion → Local, et saisissez http://<ip-du-serveur>:8410.

L'écran de connexion propose Créer votre compte administrateur tant que le serveur n'a aucun utilisateur. Créez-le, acceptez les conditions et activez votre clé (Licence).

Faites-le immédiatement après le premier démarrage, depuis un poste de confiance. Un serveur vide est appropriable par le premier arrivé.

Ce qui vient de démarrer

Le schéma de la base est créé automatiquement au premier démarrage, et à chaque mise à jour : vous ne lancez jamais de migration à la main. Avant un changement de schéma, le backend sauvegarde la base et refuse de continuer si cette sauvegarde échoue.

Étapes facultatives

Démarrage rapide (guidé)

Laisser l'application configurer la pile Docker, puis créer le premier administrateur.

Accélération GPU

Utiliser la carte graphique que vous avez déjà — la différence entre une minute et quelques secondes.