Servizio e archiviazione

Aggiornato il 10 novembre 2026

konsolity serve gestisce le richieste del connettore Claude dell'account come farebbe l'app desktop, ma senza interfaccia: Claude può agire sui tuoi server anche quando il tuo computer è spento, entro l'ambito e le regole della macchina. Richiede il dominio mcp e l'integrazione Claude del piano Studio, e il connettore Claude deve essere già aggiunto in Claude.

Provarlo in primo piano

konsolity serve

Il comando resta in primo piano e mostra ogni richiesta gestita o rifiutata. Ctrl+C lo arresta. Per un vero server, installalo come servizio.

Linux: systemd

sudo konsolity service install

Il comando:

  • crea l'utente di sistema konsolity, senza shell né password;
  • installa l'unità konsolity.service con riavvio automatico (Restart=always) e l'isolamento di systemd (ProtectSystem=strict, NoNewPrivileges=yes);
  • conserva la configurazione in /etc/konsolity/ e lo stato in /var/lib/konsolity/;
  • cifra i segreti con systemd-creds (vedi sotto);
  • copia il binario in /usr/local/bin/konsolity (la sandbox nasconde /home al servizio);
  • installa il timer konsolity-update.timer, che due volte al giorno controlla la versione firmata, aggiorna il binario e riavvia il servizio;
  • abilita e avvia il servizio.

Il servizio parte con il sistema e si riavvia da solo dopo un errore o un'interruzione di rete. I suoi log:

journalctl -u konsolity
journalctl -u konsolity -f

Più server: relay principale e di riserva

Attiva Konsolity CLI su due o più server, ciascuno con service install. Un solo relay gestisce ogni richiesta di Claude: quello con la priorità più alta (Impostazioni › Claude › Relay di Claude). Gli altri restano di riserva, senza app né Mac accesi.

Se il relay principale si ferma correttamente, il successivo subentra entro un secondo. Se cade senza preavviso, il successivo prende una richiesta rimasta senza risposta dopo 6 secondi, il terzo dopo 12 secondi. Una richiesta non viene mai eseguita due volte. Il registro indica il ruolo di ogni macchina: «Relay attivo» o «Di riserva».

Perché un relay di riserva prenda anche i comandi, le sue regole devono consentire comandi (Impostazioni › Macchine CLI › la macchina › Regole). Altrimenti prende solo le letture (host, snippet, sessioni).

macOS: launchd

sudo konsolity service install

Installa il servizio launchd com.konsolity.cli, riavviato automaticamente (KeepAlive). I segreti sono conservati nel portachiavi. I log si trovano nell'app Console.

Windows: attività pianificata

In un PowerShell da amministratore:

konsolity service install

Crea un'attività pianificata che avvia konsolity serve all'avvio di Windows e lo riavvia dopo un errore.

Verificare

konsolity status

status indica se la macchina è raggiungibile, l'età del token, l'ambito e il numero di host raggiungibili. La macchina compare online nell'elenco delle Macchine CLI finché ha dato un segno di vita nell'ultimo minuto.

Cartelle

Percorso Contenuto
~/.config/konsolity/ Linux e macOS, uso senza servizio: config.json e segreti
%APPDATA%\Konsolity\cli\ Windows: config.json e credentials.bin
/etc/konsolity/ Servizio Linux: configurazione
/var/lib/konsolity/ Servizio Linux: segreti cifrati e stato

config.json (indirizzo del server, identificativo e nome della macchina, ambito visualizzato) ha permessi 0600. Non contiene alcun segreto.

Archiviazione dei segreti

I segreti della macchina sono il suo token e la sua chiave della macchina. Vengono conservati in base al sistema:

Sistema Archiviazione
macOS Portachiavi (elemento com.konsolity.cli)
Linux, come servizio systemd-creds encrypt, con il TPM se la macchina ne ha uno, altrimenti con la chiave dell'host
Linux, senza systemd-creds file credentials.bin, 0600
Windows DPAPI (utente corrente) in credentials.bin, accesso riservato al solo account

In ogni caso, il contenuto viene prima cifrato con una chiave derivata dall'identificativo della macchina: copiato su un altro computer, è illeggibile. I segreti non compaiono mai in un log, in un argomento della riga di comando o in una variabile d'ambiente, tranne KONSOLITY_TOKEN che scegli tu di fornire per un token di lunga durata.

Rotazione automatica del token

Il token di una macchina viene rinnovato automaticamente ogni 24 ore, senza interruzioni: il vecchio token resta accettato fino alla prima chiamata effettuata con quello nuovo, per 10 minuti al massimo. Per forzare una rotazione (dopo il ripristino di un backup, dopo che un terzo è intervenuto sulla macchina):

konsolity rotate

I token di lunga durata (setup-token) non hanno rotazione automatica; scadono al più tardi dopo un anno.

Rimuovere il servizio

sudo konsolity service uninstall

Il servizio viene arrestato e rimosso. La macchina resta attivata sul tuo account: per disattivarla del tutto, esegui konsolity logout o revocala dall'elenco delle Macchine CLI.