lea · Help

Troubleshooting

• Start with lea doctor. It checks lea's managed settings, Docker and the host versions (kernel, Docker Engine, containerd, runc), the images, the proxy and the internal networks, tmux, the AppArmor profile, the projects directory and the configuration, then each lock lox runs against lea's client of its type (config/locks.lock), with the fix to run when they differ.
• An agent cannot reach a host. Private and link-local addresses are refused on purpose; add the host to LEA_INTERNAL_HOSTS. A public domain outside lea's default list goes in LEA_EGRESS_ALLOW (default,<domain>); a public IP literal or a DNS-over-HTTPS resolver is always refused. The proxy's refusal page says which host it refused and why.
• A change to ~/.claude does not show. Single files are mounted as they were at start: lea stop, then lea.
• docker compose fails with a network error. Known limitation, below; docker run works.