diff --git a/docker/.env.example b/docker/.env.example
index ecafac1f3c..89adbed8a5 100644
--- a/docker/.env.example
+++ b/docker/.env.example
@@ -78,13 +78,14 @@ IMMICH_SERVER_URL=http://immich-server:3001
 IMMICH_MACHINE_LEARNING_URL=http://immich-machine-learning:3003
 
 ####################################################################################
-# Public Facing API Server URL - Optional
+# Alternative Public Server Address - Optional
 #
-# This should point to the publicly accessible URL of the API (default is "/api")
-# Use a full URL here if you want to serve the API via a dedicated domain.
+# This is an advanced feature used to control the public server endpoint returned to clients during Well-known discovery.
+# You should only use this if the API server is exposed publicly via a custom host/path.
+# Examples: http://localhost:3001, http://immich-api.example.com, etc
 ####################################################################################
 
-IMMICH_SERVER_PUBLIC_URL=/api
+IMMICH_SERVER_PUBLIC_URL=http://localhost:3001
 
 ####################################################################################
 # API Cors Allowed Origins - Optional