Command Line Tools
wheels deploy proxy
The kamal-proxy container is a singleton per host. Every proxy verb iterates all hosts (across every role) and applies the same command.
| Verb | Purpose |
|------|---------|
| boot | First-time install + run. |
| reboot | Stop, remove, and re-install. |
| start | docker start the existing proxy. |
| stop | docker stop the proxy. |
| restart | docker restart the proxy. |
| details | docker ps filtered to kamal-proxy. |
| logs | Tail the proxy logs. |
| remove | Stop + remove the proxy container. |
Port collisions
Section titled “Port collisions”kamal-proxy binds :80 and :443 directly on the host. If nginx, Traefik, or any other process is already on those ports, proxy boot fails fast. Stop the conflicting service before booting the proxy.