diff --git a/docs/docs/30-administration/10-configuration/40-autoscaler.md b/docs/docs/30-administration/10-configuration/40-autoscaler.md
index 0ad43a30b..e1b105ee9 100644
--- a/docs/docs/30-administration/10-configuration/40-autoscaler.md
+++ b/docs/docs/30-administration/10-configuration/40-autoscaler.md
@@ -27,7 +27,7 @@ services:
       - WOODPECKER_MIN_AGENTS=0
       - WOODPECKER_MAX_AGENTS=3
       - WOODPECKER_WORKFLOWS_PER_AGENT=2 # the number of workflows each agent can run at the same time
-      - WOODPECKER_GRPC_ADDR=https://grpc.your-woodpecker-server.tld # the grpc address of your woodpecker server, publicly accessible from the agents
+      - WOODPECKER_GRPC_ADDR=grpc.your-woodpecker-server.tld # the grpc address of your woodpecker server, publicly accessible from the agents. See https://woodpecker-ci.org/docs/administration/configuration/server#caddy for an example of how to expose it. Do not include "https://" in the value.
       - WOODPECKER_GRPC_SECURE=true
       - WOODPECKER_AGENT_ENV= # optional environment variables to pass to the agents
       - WOODPECKER_PROVIDER=hetznercloud # set the provider, you can find all the available ones down below
diff --git a/docs/versioned_docs/version-3.5/30-administration/10-configuration/40-autoscaler.md b/docs/versioned_docs/version-3.5/30-administration/10-configuration/40-autoscaler.md
index 0ad43a30b..e1b105ee9 100644
--- a/docs/versioned_docs/version-3.5/30-administration/10-configuration/40-autoscaler.md
+++ b/docs/versioned_docs/version-3.5/30-administration/10-configuration/40-autoscaler.md
@@ -27,7 +27,7 @@ services:
       - WOODPECKER_MIN_AGENTS=0
       - WOODPECKER_MAX_AGENTS=3
       - WOODPECKER_WORKFLOWS_PER_AGENT=2 # the number of workflows each agent can run at the same time
-      - WOODPECKER_GRPC_ADDR=https://grpc.your-woodpecker-server.tld # the grpc address of your woodpecker server, publicly accessible from the agents
+      - WOODPECKER_GRPC_ADDR=grpc.your-woodpecker-server.tld # the grpc address of your woodpecker server, publicly accessible from the agents. See https://woodpecker-ci.org/docs/administration/configuration/server#caddy for an example of how to expose it. Do not include "https://" in the value.
       - WOODPECKER_GRPC_SECURE=true
       - WOODPECKER_AGENT_ENV= # optional environment variables to pass to the agents
       - WOODPECKER_PROVIDER=hetznercloud # set the provider, you can find all the available ones down below