Service et stockage

Mis à jour le 10 novembre 2026

konsolity serve traite les demandes du connecteur Claude du compte comme le ferait l'app d'ordinateur, mais sans interface : Claude peut agir sur vos serveurs même quand votre ordinateur est éteint, dans la limite de la portée et des règles de la machine. Il demande le domaine mcp et l'intégration Claude de l'offre Studio, et le connecteur Claude doit déjà être ajouté dans Claude.

Essayer au premier plan

konsolity serve

La commande reste au premier plan et affiche chaque demande traitée ou refusée. Ctrl+C l'arrête. Pour un vrai serveur, installez-la comme service.

Linux : systemd

sudo konsolity service install

La commande :

  • crée l'utilisateur système konsolity, sans shell ni mot de passe ;
  • installe l'unité konsolity.service avec redémarrage automatique (Restart=always) et le bac à sable systemd (ProtectSystem=strict, NoNewPrivileges=yes) ;
  • range la configuration dans /etc/konsolity/ et l'état dans /var/lib/konsolity/ ;
  • chiffre les secrets avec systemd-creds (voir plus bas) ;
  • copie le binaire dans /usr/local/bin/konsolity (le bac à sable cache /home au service) ;
  • installe le minuteur konsolity-update.timer, qui vérifie deux fois par jour la version signée, met à jour le binaire et redémarre le service ;
  • active et démarre le service.

Le service démarre avec le système et redémarre seul après une erreur ou une coupure réseau. Ses journaux :

journalctl -u konsolity
journalctl -u konsolity -f

Plusieurs serveurs : relais principal et secours

Activez Konsolity CLI sur deux serveurs ou plus, chacun avec service install. Un seul relais traite chaque requête de Claude : celui de plus haute priorité (Réglages › Claude › Relais de Claude). Les autres restent en secours, sans app ni Mac allumé.

Si le relais principal s'arrête proprement, le suivant reprend dans la seconde. S'il tombe sans prévenir, le suivant reprend une requête restée sans réponse au bout de 6 secondes, le troisième au bout de 12 secondes. Une requête n'est jamais exécutée deux fois. Le journal indique le rôle de chaque machine : « Relais actif » ou « En secours ».

Pour qu'un relais de secours reprenne aussi les commandes, ses règles doivent autoriser des commandes (Réglages › Machines CLI › la machine › Règles). Sinon il ne reprend que les lectures (hôtes, snippets, sessions).

macOS : launchd

sudo konsolity service install

Installe le service launchd com.konsolity.cli, relancé automatiquement (KeepAlive). Les secrets sont rangés dans le trousseau. Les journaux sont dans l'app Console.

Windows : tâche planifiée

Dans un PowerShell administrateur :

konsolity service install

Crée une tâche planifiée qui lance konsolity serve au démarrage de Windows et la relance après une erreur.

Vérifier

konsolity status

status dit si la machine est joignable, l'âge du jeton, la portée et le nombre d'hôtes accessibles. La machine apparaît en ligne dans la liste des machines CLI tant qu'elle a donné signe de vie dans la dernière minute.

Dossiers

Chemin Contenu
~/.config/konsolity/ Linux et macOS, utilisation sans service : config.json et secrets
%APPDATA%\Konsolity\cli\ Windows : config.json et credentials.bin
/etc/konsolity/ Service Linux : configuration
/var/lib/konsolity/ Service Linux : secrets chiffrés et état

config.json (adresse du serveur, identifiant et nom de la machine, portée affichée) est en 0600. Il ne contient aucun secret.

Stockage des secrets

Les secrets de la machine sont son jeton et sa clé de machine. Ils sont rangés selon le système :

Système Stockage
macOS Trousseau (élément com.konsolity.cli)
Linux, en service systemd-creds encrypt, par le TPM quand la machine en a un, sinon par la clé de l'hôte
Linux, sans systemd-creds fichier credentials.bin en 0600
Windows DPAPI (utilisateur courant) dans credentials.bin, accès réservé au seul compte

Dans tous les cas, le contenu est d'abord chiffré par une clé dérivée de l'identifiant de la machine : recopié sur un autre ordinateur, il est illisible. Les secrets n'apparaissent jamais dans un journal, un argument de ligne de commande ni une variable d'environnement, sauf KONSOLITY_TOKEN que vous choisissez de fournir pour un jeton longue durée.

Rotation automatique du jeton

Le jeton d'une machine est renouvelé automatiquement toutes les 24 heures, sans interruption : l'ancien jeton reste accepté jusqu'au premier appel fait avec le nouveau, 10 minutes au plus. Pour forcer une rotation (après une restauration de sauvegarde, une intervention d'un tiers) :

konsolity rotate

Les jetons longue durée (setup-token) n'ont pas de rotation automatique ; ils expirent au plus tard au bout d'un an.

Retirer le service

sudo konsolity service uninstall

Le service est arrêté et retiré. La machine reste activée sur votre compte : pour la couper aussi, lancez konsolity logout ou révoquez-la depuis la liste des machines CLI.