Referência

Docker e servidores

Docker§

O agente inteiro — inclusive os comandos que ele executa — fica dentro do contêiner. Monte seu projeto como espaço de trabalho (workspace):

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

Depois abra http://127.0.0.1:8080. A partir de um clone, docker build -t lampson .; o docker-compose.yml faz o mesmo, com sessões e memória persistentes.

Em um VPS§

Instale como em qualquer máquina Linux (o instalador de uma linha ou npm i -g lampson) e depois mantenha o hub vivo:

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

Os processos dos espaços de trabalho nunca saem do loopback. Para acessar de fora com seu próprio domínio e HTTPS (opcional):

lampson --domain lampson.example.com --email you@example.com

O Lampson obtém um certificado gratuito do Let's Encrypt, renova sozinho e serve o hub em https://lampson.example.com; o hub deixa de escutar na rede. É preciso um registro DNS A/AAAA apontando para o servidor, as portas 80 e 443 abertas e, no Linux sem root, sudo setcap cap_net_bind_service=+ep $(command -v synsema). lampson --domain mostra o estado e lampson --domain off volta tudo ao que era. Sem --domain, nada muda. Para parear o celular pelo servidor: lampson --pair por SSH mostra o QR no terminal (No celular).

Pelo celular§

Parear o celular com uma passkey, instalar o app e conectar seu PC de casa por um túnel: No celular.

Os links de aprovação de uso único continuam públicos de propósito — o token é a autorização e morre com o prazo. LAMPSON_WEB_TOKEN (Bearer) continua valendo para scripts. Veja Tarefas agendadas para aprovar pelo celular.

Requisitos§

• Linux: o binário synsema precisa de glibc ≥ 2.17 (qualquer distribuição desde 2014: Ubuntu 20.04+, Debian 11+, RHEL 7+).
• Windows: PowerShell (o que já vem instalado serve) e Git para Windows (o bash dele executa os comandos).
• macOS: nada além disso.