From 6c5af69675a5ba1918dfcfa1fee5849c5682f443 Mon Sep 17 00:00:00 2001 From: Kristin Martin Date: Wed, 29 Jul 2026 15:26:54 +0000 Subject: [PATCH] Clarify what HTTP health checks target The health check descriptions said the check hits http://appname.fly.dev/, implying the public hostname and an external port. The proxy runs the check against the service on the Machine over the private network, so it works even for services that aren't exposed publicly. Reword both the http_service.checks and services.http_checks descriptions to match. --- reference/configuration.html.markerb | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/reference/configuration.html.markerb b/reference/configuration.html.markerb index c96998a965..1ef3b2c1ee 100644 --- a/reference/configuration.html.markerb +++ b/reference/configuration.html.markerb @@ -489,7 +489,7 @@ To configure health checks for your HTTP service, you can use the `http_service. path = "/" ``` -Roughly translated, this section says every thirty seconds, perform an HTTP GET on the root path (e.g. http://appname.fly.dev/) looking for it to return an HTTP 200 status within five seconds. The parameters of a `check` are listed below. +Roughly translated, this section says every thirty seconds, perform an HTTP GET on the root path of the service, looking for it to return an HTTP 200 status within five seconds. The check runs against the service on the Machine over the app's private network, not against the public `appname.fly.dev` hostname, so it works even for services that aren't exposed publicly. The parameters of a `check` are listed below. Times are in milliseconds unless units are specified. @@ -790,7 +790,7 @@ Another way of checking a service is running is through HTTP checks as defined i [services.http_checks.headers] ``` -Roughly translated, this section says every ten seconds, perform an HTTP GET on the root path (e.g. http://appname.fly.dev/) looking for it to return an HTTP 200 status within two seconds. The parameters of a `http_check` are listed below. +Roughly translated, this section says every ten seconds, perform an HTTP GET on the root path of the service, looking for it to return an HTTP 200 status within two seconds. The check runs against the service on the Machine over the app's private network, not against the public `appname.fly.dev` hostname, so it works even for services that aren't exposed publicly. The parameters of a `http_check` are listed below. Times are in milliseconds unless units are specified.