Service en opslag

Bijgewerkt op 10 november 2026

konsolity serve handelt de verzoeken van de Claude-connector van het account af zoals de desktop-app dat zou doen, maar zonder interface: Claude kan op je servers werken, zelfs als je computer uit staat, binnen het bereik en de regels van de machine. Het vereist het domein mcp en de Claude-integratie van het abonnement Studio, en de Claude-connector moet al aan Claude zijn toegevoegd.

Proberen op de voorgrond

konsolity serve

De opdracht blijft op de voorgrond draaien en toont elk afgehandeld of geweigerd verzoek. Ctrl+C stopt hem. Installeer hem op een echte server als service.

Linux: systemd

sudo konsolity service install

De opdracht:

  • maakt de systeemgebruiker konsolity aan, zonder shell en zonder wachtwoord;
  • installeert de unit konsolity.service met automatische herstart (Restart=always) en de sandbox van systemd (ProtectSystem=strict, NoNewPrivileges=yes);
  • bewaart de configuratie in /etc/konsolity/ en de status in /var/lib/konsolity/;
  • versleutelt de geheimen met systemd-creds (zie hieronder);
  • kopieert het programma naar /usr/local/bin/konsolity (de sandbox verbergt /home voor de service);
  • installeert de timer konsolity-update.timer, die twee keer per dag de ondertekende versie controleert, het programma bijwerkt en de service herstart;
  • schakelt de service in en start hem.

De service start met het systeem en herstart vanzelf na een fout of een netwerkstoring. Zijn logboeken:

journalctl -u konsolity
journalctl -u konsolity -f

Meerdere servers: hoofdrelay en reserve

Activeer Konsolity CLI op twee of meer servers, elk met service install. Eén relay behandelt elk verzoek van Claude: die met de hoogste prioriteit (Instellingen › Claude › Relays van Claude). De andere staan in reserve, zonder app of Mac aan.

Stopt de hoofdrelay netjes, dan neemt de volgende het binnen een seconde over. Valt hij onverwacht uit, dan neemt de volgende een onbeantwoord verzoek na 6 seconden over, de derde na 12 seconden. Een verzoek wordt nooit twee keer uitgevoerd. Het logboek toont de rol van elke machine: "Actieve relay" of "Reserve".

Wil je dat een reserverelay ook commando's overneemt, dan moeten zijn regels commando's toestaan (Instellingen › CLI-machines › de machine › Regels). Anders neemt hij alleen het lezen over (hosts, snippets, sessies).

macOS: launchd

sudo konsolity service install

Installeert de launchd-service com.konsolity.cli, die automatisch wordt herstart (KeepAlive). De geheimen worden in de sleutelhanger bewaard. De logboeken staan in de app Console.

Windows: geplande taak

In een PowerShell met beheerdersrechten:

konsolity service install

Maakt een geplande taak aan die konsolity serve start bij het opstarten van Windows en hem na een fout herstart.

Controleren

konsolity status

status geeft aan of de machine bereikbaar is, de leeftijd van het token, het bereik en het aantal bereikbare hosts. De machine verschijnt als online in de lijst CLI-machines zolang ze in de laatste minuut een teken van leven heeft gegeven.

Mappen

Pad Inhoud
~/.config/konsolity/ Linux en macOS, gebruik zonder service: config.json en geheimen
%APPDATA%\Konsolity\cli\ Windows: config.json en credentials.bin
/etc/konsolity/ Linux-service: configuratie
/var/lib/konsolity/ Linux-service: versleutelde geheimen en status

config.json (adres van de server, identificatie en naam van de machine, getoond bereik) staat op 0600. Het bevat geen geheim.

Opslag van geheimen

De geheimen van de machine zijn haar token en haar machinesleutel. Ze worden afhankelijk van het systeem bewaard:

Systeem Opslag
macOS Sleutelhanger (item com.konsolity.cli)
Linux, als service systemd-creds encrypt, met de TPM als de machine er een heeft, anders met de hostsleutel
Linux, zonder systemd-creds bestand credentials.bin, 0600
Windows DPAPI (huidige gebruiker) in credentials.bin, toegang beperkt tot alleen het account

In alle gevallen wordt de inhoud eerst versleuteld met een sleutel die is afgeleid van de machine-identificatie: gekopieerd naar een andere computer is hij onleesbaar. Geheimen verschijnen nooit in een logboek, een argument op de opdrachtregel of een omgevingsvariabele, behalve KONSOLITY_TOKEN, dat je zelf kiest door te geven voor een langlevend token.

Automatische rotatie van het token

Het token van een machine wordt automatisch elke 24 uur vernieuwd, zonder onderbreking: het oude token blijft geaccepteerd tot de eerste aanroep met het nieuwe, maximaal 10 minuten. Om een rotatie af te dwingen (na het terugzetten van een back-up, nadat een derde aan de machine heeft gewerkt):

konsolity rotate

Langlevende tokens (setup-token) worden niet automatisch vernieuwd; ze verlopen uiterlijk na een jaar.

De service verwijderen

sudo konsolity service uninstall

De service wordt gestopt en verwijderd. De machine blijft geactiveerd op je account: om haar ook af te sluiten, voer je konsolity logout uit of trek je haar in vanuit de lijst CLI-machines.