Tjeneste og lagring

Oppdatert 10. november 2026

konsolity serve behandler forespørslene fra kontoens Claude-kobling slik skrivebordsappen ville gjort, men uten grensesnitt: Claude kan arbeide på serverne dine selv når datamaskinen din er slått av, innenfor maskinens omfang og regler. Den krever domenet mcp og Claude-integrasjonen i Studio-planen, og Claude-koblingen må allerede være lagt til i Claude.

Prøv i forgrunnen

konsolity serve

Kommandoen kjører i forgrunnen og viser hver forespørsel som behandles eller avvises. Ctrl+C stopper den. På en ordentlig server installerer du den som tjeneste.

Linux: systemd

sudo konsolity service install

Kommandoen:

  • oppretter systembrukeren konsolity, uten skall og uten passord;
  • installerer enheten konsolity.service med automatisk omstart (Restart=always) og systemd-sandkassen (ProtectSystem=strict, NoNewPrivileges=yes);
  • lagrer konfigurasjonen i /etc/konsolity/ og tilstanden i /var/lib/konsolity/;
  • krypterer hemmelighetene med systemd-creds (se nedenfor);
  • kopierer programmet til /usr/local/bin/konsolity (sandkassen skjuler /home for tjenesten);
  • installerer tidtakeren konsolity-update.timer, som sjekker den signerte versjonen to ganger om dagen, oppdaterer programmet og starter tjenesten på nytt;
  • aktiverer og starter tjenesten.

Tjenesten starter sammen med systemet og starter seg selv på nytt etter en feil eller et nettverksbrudd. Loggene:

journalctl -u konsolity
journalctl -u konsolity -f

Flere servere: hovedrelé og reserve

Aktiver Konsolity CLI på to eller flere servere, hver med service install. Ett relé behandler hver Claude-forespørsel: det med høyest prioritet (Innstillinger › Claude › Claude-reléer). De andre står i reserve, uten app eller Mac påslått.

Stopper hovedreléet på vanlig måte, tar det neste over innen ett sekund. Faller det ut uten varsel, tar det neste over en ubesvart forespørsel etter 6 sekunder, det tredje etter 12 sekunder. En forespørsel kjøres aldri to ganger. Loggen viser rollen til hver maskin: «Aktivt relé» eller «Reserve».

For at et reserverelé også skal ta over kommandoer, må reglene tillate kommandoer (Innstillinger › CLI-maskiner › maskinen › Regler). Ellers tar det bare over lesing (verter, snippets, økter).

macOS: launchd

sudo konsolity service install

Installerer launchd-tjenesten com.konsolity.cli, som startes på nytt automatisk (KeepAlive). Hemmelighetene lagres i nøkkelringen. Loggene finner du i Konsoll-appen.

Windows: planlagt oppgave

I et PowerShell-vindu som administrator:

konsolity service install

Oppretter en planlagt oppgave som starter konsolity serve når Windows starter, og starter den på nytt etter en feil.

Kontroller

konsolity status

status viser om maskinen kan nås, tokenets alder, omfanget og antall verter som kan nås. Maskinen vises som tilkoblet i listen CLI-maskiner så lenge den har gitt livstegn i løpet av det siste minuttet.

Mapper

Sti Innhold
~/.config/konsolity/ Linux og macOS, bruk uten tjeneste: config.json og hemmeligheter
%APPDATA%\Konsolity\cli\ Windows: config.json og credentials.bin
/etc/konsolity/ Linux-tjeneste: konfigurasjon
/var/lib/konsolity/ Linux-tjeneste: krypterte hemmeligheter og tilstand

config.json (serveradresse, maskinens identifikator og navn, omfanget som vises) har 0600. Den inneholder ingen hemmeligheter.

Lagring av hemmeligheter

Maskinens hemmeligheter er tokenet og maskinnøkkelen. De lagres avhengig av systemet:

System Lagring
macOS Nøkkelring (elementet com.konsolity.cli)
Linux, som tjeneste systemd-creds encrypt, med TPM når maskinen har en, ellers med vertsnøkkelen
Linux, uten systemd-creds Filen credentials.bin, 0600
Windows DPAPI (gjeldende bruker) i credentials.bin, tilgang begrenset til kontoen alene

I alle tilfeller krypteres innholdet først med en nøkkel avledet fra maskinidentifikatoren: kopiert til en annen datamaskin er det uleselig. Hemmeligheter vises aldri i en logg, et kommandolinjeargument eller en miljøvariabel, bortsett fra KONSOLITY_TOKEN, som du selv velger å oppgi for et langvarig token.

Automatisk tokenrotasjon

Tokenet til en maskin fornyes automatisk hver 24. time, uten avbrudd: det gamle tokenet godtas fram til det første kallet med det nye, maks 10 minutter. Slik tvinger du en rotasjon (etter gjenoppretting av en sikkerhetskopi, etter at en tredjepart har arbeidet på maskinen):

konsolity rotate

Langvarige tokener (setup-token) har ingen automatisk rotasjon; de utløper senest etter ett år.

Fjern tjenesten

sudo konsolity service uninstall

Tjenesten stoppes og fjernes. Maskinen forblir aktivert på kontoen din: for å koble den fra også kjører du konsolity logout eller tilbakekaller den fra listen CLI-maskiner.