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. Para entrar desde afuera con tu propio dominio y HTTPS (opcional):
lampson --domain lampson.example.com --email you@example.com
Lampson pide un certificado gratis a Let's Encrypt, lo renueva solo y sirve el hub por https://lampson.example.com; el hub deja de escuchar en la red. Hace falta un registro DNS A/AAAA que apunte al servidor, los puertos 80 y 443 abiertos y, en Linux sin root, sudo setcap cap_net_bind_service=+ep $(command -v synsema). lampson --domain muestra el estado y lampson --domain off vuelve a como estaba. Sin --domain no cambia nada. Para emparejar el teléfono desde el servidor: lampson --pair por SSH muestra el QR en la terminal (En el celular).
Desde el celular§
Emparejar el teléfono con una passkey, instalar la app y conectar tu PC de casa con un túnel: En el celular.
Los enlaces de aprobación de un solo uso siguen siendo públicos a propósito — el token es la autorización y muere con el plazo. LAMPSON_WEB_TOKEN (Bearer) sigue sirviendo para scripts. Consulta Tareas programadas para aprobar desde tu teléfono. Requisitos§
- Linux: el binario
synsemanecesita glibc ≥ 2.17 (cualquier distribución desde 2014: Ubuntu 20.04+, Debian 11+, RHEL 7+). - Windows: PowerShell (el que viene incluido sirve) y Git para Windows (su bash ejecuta los comandos).
- macOS: nada extra.