diff --git a/README.md b/README.md
index c34297e35..fec0d424d 100644
--- a/README.md
+++ b/README.md
@@ -191,7 +191,7 @@ There are a few shortcut keys available when using the console.
 
 ## Port Configuration
 
-Ports are configured in the `docker-compose.yml` file. If you change the internal port for the container, make sure you update `ASPNETCORE_HTTP_PORTS` variable to match.
+The host port (left side) can be configured in `docker-compose.yml`.  The container port (right side) should not be changed. See the [compose docs](https://docs.docker.com/compose/compose-file/05-services/#ports) for details.
 
 ## API and Integrations
 
diff --git a/docker-compose/docker-compose.yml b/docker-compose/docker-compose.yml
index 531a5a252..ae9391a2a 100644
--- a/docker-compose/docker-compose.yml
+++ b/docker-compose/docker-compose.yml
@@ -21,8 +21,10 @@ services:
     networks:
       - remotely
     environment:
+      # ASPNETCORE environment variables should *not* be changed.
       - ASPNETCORE_ENVIRONMENT=Production
       - ASPNETCORE_HTTP_PORTS=5000
+
       # Other ASP.NET Core configurations can be overridden here, such as Logging.
       # See https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-8.0
       - Serilog__MinimumLevel__Override__Microsoft.AspNetCore=Warning