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.