# Kamal Proxy

**Canonical:** https://apis.io/apis/kamal-deploy/kamal-proxy/  
**Provider:** Kamal — https://apis.io/providers/kamal-deploy/  
**Documentation:** https://github.com/basecamp/kamal-proxy

Kamal Proxy is one of 2 APIs that [Kamal](https://apis.io/providers/kamal-deploy/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Proxy, HTTP, Load Balancing, Zero Downtime, and TLS. The published artifact set on APIs.io includes API documentation and a GitHub repository.

Kamal Proxy is a minimal HTTP reverse proxy written in Go that powers the zero-downtime deploy switchover behind Kamal. It exposes a small `kamal-proxy` CLI with `run`, `deploy`, and `remove` commands; the Kamal CLI talks to it over SSH to register new container instances (`hostname:port`), runs health checks (default `GET /up` once per second returning `200`), drains traffic from old instances, and atomically switches new traffic to the healthy instance. The proxy supports host-based routing (multiple apps on one server), path-based routing with optional prefix stripping, custom health-check paths/ports/timeouts, automatic TLS via Let's Encrypt, and custom TLS certificate/key files (useful for Cloudflare origin certs or private CAs). It can also be run standalone outside of Kamal.

## Machine-readable artifacts (5)

- **Documentation** — https://github.com/basecamp/kamal-proxy/blob/main/README.md
- **Source** — https://github.com/basecamp/kamal-proxy
- **GitHubRepository** — https://github.com/basecamp/kamal-proxy
- **License** — https://github.com/basecamp/kamal-proxy/blob/main/MIT-LICENSE
- **Dockerfile** — https://github.com/basecamp/kamal-proxy/blob/main/Dockerfile

## Other Kamal APIs (1)

- [Kamal CLI](https://apis.io/apis/kamal-deploy/kamal/)

## Tags

Proxy, HTTP, Load Balancing, Zero Downtime, TLS, Go

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kamal-deploy/kamal-proxy/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kamal-deploy/.