diff --git a/docs/docs/configuration/advanced.md b/docs/docs/configuration/advanced.md
index 4c7341229..b8dbffd62 100644
--- a/docs/docs/configuration/advanced.md
+++ b/docs/docs/configuration/advanced.md
@@ -178,7 +178,7 @@ networking:
 
 :::warning
 
-This setting is for advanced users. For the majority of use cases it's recommended to use docker's `--publish` option instead, e.g. `-p 443:8971`. Changing Frigate's ports may break some integrations.
+This setting is for advanced users. For the majority of use cases it's recommended to change the `ports` section of your Docker compose file or use the Docker `run` `--publish` option instead, e.g. `-p 443:8971`. Changing Frigate's ports may break some integrations.
 
 :::
 
diff --git a/docs/docs/configuration/reference.md b/docs/docs/configuration/reference.md
index 76a885b66..b318bd7f0 100644
--- a/docs/docs/configuration/reference.md
+++ b/docs/docs/configuration/reference.md
@@ -81,7 +81,8 @@ networking:
   # Optional: Override ports Frigate uses for listening (defaults: shown below)
   # An IP address may also be provided to bind to a specific interface, e.g. ip:port
   # NOTE: This setting is for advanced users and may break some integrations. The majority
-  #       of users should use docker's `--publish` option to select a different port.
+  #       of users should change ports in the docker compose file
+  #       or use the docker run `--publish` option to select a different port.
   listen:
     internal: 5000
     external: 8971