diff --git a/Dockerfile b/Dockerfile
index 1928aeede15c4a1b86f4380644d645f45a91b71f..ae2cef11c97fc74549c336fb78f7d1a820b0f646 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -8,13 +8,16 @@ RUN pip install \
     geant-service-orchestrator==${ARTIFACT_VERSION}
 
 # Create the directory for the configuration and copy the example config into it
+# NOTE: a real config must be mounted at
+# /etc/gso/config.json when running the container
 RUN mkdir -p /etc/gso
 COPY gso/oss-params-example.json /etc/gso/config.json
 
-# Expose port 8000 for the FastAPI application
+# Expose port 8080 for the FastAPI application
 EXPOSE 8080
 
-# Set the environment variable for the configuration file
+# The app reads the configuration from this location.
+# No need to set environment variables in your docker-compose.
 ENV OSS_PARAMS_FILENAME=/etc/gso/config.json
 
 # Start the FastAPI application