Service et stockage
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.serviceavec 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/homeau 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.