Referencia

Docker y servidores

Docker§

Todo el agente — incluidos los comandos que ejecuta — se queda dentro del contenedor. Monta tu proyecto como espacio de trabajo (workspace):

docker run --rm -p 8080:8080 -v "$PWD:/lampson/workspace" \
  -e LAMPSON_PROVIDER=deepseek -e LAMPSON_API_KEY=sk-... ghcr.io/kitecosmic/lampson

Luego abre http://127.0.0.1:8080. Desde un clon, docker build -t lampson .; docker-compose.yml hace lo mismo con sesiones y memoria persistentes.

En un VPS§

Instala como en cualquier máquina Linux (el instalador de una línea o npm i -g lampson) y luego mantén el hub vivo:

lampson --install        # unidad systemd --user, Restart=always
lampson --hub status

Los procesos de los espacios de trabajo nunca salen de loopback. Pon el hub detrás de tu dominio — ya sea con Synsema directamente:

synsema serve ~/lampson/hub.syn --port 443 --domain lampson.example.com --tls-auto you@example.com

o detrás del proxy inverso que ya tengas. Define LAMPSON_PUBLIC_URL=https://lampson.example.com para que los enlaces de aprobación lleven la dirección correcta. Consulta Tareas programadas para aprobar desde tu teléfono.

La API web responde solo a clientes de loopback; a través de tu proxy, protégela como proteges cualquier otra cosa en ese host (autenticación básica, un proxy con identidad, una VPN). Los enlaces de aprobación de un solo uso son el único camino pensado para ser público — el token es la autorización y muere con el plazo.

Requisitos§

• Linux: el binario synsema necesita glibc ≥ 2.39 (Ubuntu 24.04+, Debian 13+, Fedora 40+).
• Windows: PowerShell (el que viene incluido sirve) y Git para Windows (su bash ejecuta los comandos).
• macOS: nada extra.