Servicio y almacenamiento

Actualizado el 10 de noviembre de 2026

konsolity serve atiende las solicitudes del conector Claude de la cuenta como lo haría la app de escritorio, pero sin interfaz: Claude puede actuar en tus servidores incluso con tu ordenador apagado, dentro de los límites del alcance y de las reglas de la máquina. Requiere el ámbito mcp y la integración con Claude del plan Studio, y el conector Claude ya debe estar añadido en Claude.

Probar en primer plano

konsolity serve

El comando se queda en primer plano y muestra cada solicitud atendida o rechazada. Ctrl+C lo detiene. Para un servidor de verdad, instálalo como servicio.

Linux: systemd

sudo konsolity service install

El comando:

  • crea el usuario del sistema konsolity, sin shell ni contraseña;
  • instala la unidad konsolity.service con reinicio automático (Restart=always) y el aislamiento de systemd (ProtectSystem=strict, NoNewPrivileges=yes);
  • guarda la configuración en /etc/konsolity/ y el estado en /var/lib/konsolity/;
  • cifra los secretos con systemd-creds (consulta más abajo);
  • copia el binario en /usr/local/bin/konsolity (el entorno aislado oculta /home al servicio);
  • instala el temporizador konsolity-update.timer, que comprueba la versión firmada dos veces al día, actualiza el binario y reinicia el servicio;
  • habilita e inicia el servicio.

El servicio se inicia con el sistema y se reinicia solo tras un error o un corte de red. Sus registros:

journalctl -u konsolity
journalctl -u konsolity -f

Varios servidores: relé principal y de reserva

Active Konsolity CLI en dos o más servidores, cada uno con service install. Un solo relé atiende cada solicitud de Claude: el de mayor prioridad (Ajustes › Claude › Relés de Claude). Los demás quedan en reserva, sin app ni Mac encendido.

Si el relé principal se detiene correctamente, el siguiente toma el relevo en un segundo. Si cae sin avisar, el siguiente toma una solicitud sin respuesta a los 6 segundos, el tercero a los 12 segundos. Una solicitud nunca se ejecuta dos veces. El registro muestra el papel de cada máquina: «Relé activo» o «En reserva».

Para que un relé de reserva tome también los comandos, sus reglas deben permitir comandos (Ajustes › Máquinas CLI › la máquina › Reglas). Si no, solo toma las lecturas (hosts, snippets, sesiones).

macOS: launchd

sudo konsolity service install

Instala el servicio launchd com.konsolity.cli, que se relanza automáticamente (KeepAlive). Los secretos se guardan en el llavero. Los registros están en la app Consola.

Windows: tarea programada

En un PowerShell de administrador:

konsolity service install

Crea una tarea programada que lanza konsolity serve al iniciar Windows y lo relanza tras un error.

Comprobar

konsolity status

status indica si la máquina está accesible, la antigüedad del token, el alcance y el número de hosts accesibles. La máquina aparece en línea en la lista de máquinas CLI mientras haya dado señales de vida en el último minuto.

Carpetas

Ruta Contenido
~/.config/konsolity/ Linux y macOS, uso sin servicio: config.json y secretos
%APPDATA%\Konsolity\cli\ Windows: config.json y credentials.bin
/etc/konsolity/ Servicio de Linux: configuración
/var/lib/konsolity/ Servicio de Linux: secretos cifrados y estado

config.json (dirección del servidor, identificador y nombre de la máquina, alcance mostrado) tiene permisos 0600. No contiene ningún secreto.

Almacenamiento de los secretos

Los secretos de la máquina son su token y su clave de máquina. Se guardan según el sistema:

Sistema Almacenamiento
macOS Llavero (elemento com.konsolity.cli)
Linux, como servicio systemd-creds encrypt, con el TPM cuando la máquina tiene uno y, si no, con la clave del equipo
Linux, sin systemd-creds archivo credentials.bin con permisos 0600
Windows DPAPI (usuario actual) en credentials.bin, acceso reservado a esa cuenta

En todos los casos, el contenido se cifra primero con una clave derivada del identificador de la máquina: copiado en otro ordenador, es ilegible. Los secretos nunca aparecen en un registro, en un argumento de línea de comandos ni en una variable de entorno, salvo KONSOLITY_TOKEN, que tú decides proporcionar para un token de larga duración.

Rotación automática del token

El token de una máquina se renueva automáticamente cada 24 horas, sin interrupción: el token anterior se sigue aceptando hasta la primera llamada hecha con el nuevo, 10 minutos como máximo. Para forzar una rotación (tras restaurar una copia de seguridad o tras la intervención de un tercero):

konsolity rotate

Los tokens de larga duración (setup-token) no tienen rotación automática; caducan como muy tarde al cabo de un año.

Quitar el servicio

sudo konsolity service uninstall

El servicio se detiene y se elimina. La máquina sigue activada en tu cuenta: para cortarla también, ejecuta konsolity logout o revócala desde la lista de máquinas CLI.