diff --git a/config.sample.yaml b/config.sample.yaml
index 0a9e5648672d6cd235f80de79843e14b2ce91b74..b6df78cc9a7e8af16a919664c1f5d85377118641 100644
--- a/config.sample.yaml
+++ b/config.sample.yaml
@@ -46,7 +46,8 @@ database:
 # The configuration for the homeservers this media repository is known to control. Servers
 # not listed here will not be able to upload media.
 homeservers:
-  - name: example.org # This should match the Host header given to the media repo
+  - name: example.org # This should match the server_name of your homeserver, and the Host header
+                      # provided to the media repo.
     csApi: "https://example.org/" # The base URL to where the homeserver can actually be reached
     backoffAt: 10 # The number of consecutive failures in calling this homeserver before the
                   # media repository will start backing off. This defaults to 10 if not given.