Skip to content

Commit 7e6bcf8

Browse files
Merge pull request #82 from HLFH/main
Document --health-check-path parameter
2 parents 7a7bbcf + 702015b commit 7e6bcf8

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

README.md

+13
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,19 @@ Because traffic is only routed to a new instance once it's healthy, and traffic
5858
is drained completely from old instances before they are removed, deployments
5959
take place with zero downtime.
6060

61+
### Customizing the health check
62+
63+
By default, Kamal Proxy will test the health of each service by sending a `GET`
64+
request to `/up`, once per second. A `200` response is considered healthy.
65+
66+
If you need to customize the health checks for your application, there are a
67+
few `deploy` flags you can use. See the help for `--health-check-path`,
68+
`--health-check-timeout`, and `--health-check-interval`.
69+
70+
For example, to change the health check path to something other than `/up`, you
71+
could:
72+
73+
kamal-proxy deploy service1 --target web-1:3000 --health-check-path web/index.html
6174

6275
### Host-based routing
6376

0 commit comments

Comments
 (0)