Project-OSRM
diff --git a/‎README.md‎
Lines changed: 31 additions & 4 deletions b/‎README.md‎
Lines changed: 31 additions & 4 deletions
diff --git a/‎docker/Dockerfile‎
Lines changed: 19 additions & 0 deletions b/‎docker/Dockerfile‎
Lines changed: 19 additions & 0 deletions
diff --git a/‎docker/entrypoint.sh‎
Lines changed: 66 additions & 0 deletions b/‎docker/entrypoint.sh‎
Lines changed: 66 additions & 0 deletions
diff --git a/‎index.html‎
Lines changed: 50 additions & 1 deletion b/‎index.html‎
Lines changed: 50 additions & 1 deletion
@@ -16,8 +16,33 @@ Serves the frontend at `http://localhost:9966` running queries against the routi
 docker run -p 9966:9966 ghcr.io/project-osrm/osrm-frontend:latest
 ```
 
-Per default routing requests are made against the backend at `http://localhost:5000`.
-You can change the backend by using `-e OSRM_BACKEND='http://localhost:5001'` in the `docker run` command.
+By default Docker uses a single routing profile named `default` and sends requests to `http://localhost:5000`.
+
+### Recommended: multiple profiles with `OSRM_MODES`
+
+`OSRM_MODES` is the current Docker runtime configuration interface. It accepts a JSON array of objects with `name` and `url` fields.
+
+```bash
+docker run -p 9966:9966 \
+  -e 'OSRM_MODES=[{"name":"car","url":"https://routing.openstreetmap.de/routed-car"},{"name":"foot","url":"https://routing.openstreetmap.de/routed-foot"},{"name":"bike","url":"https://routing.openstreetmap.de/routed-bike"}]' \
+  ghcr.io/project-osrm/osrm-frontend:latest
+```
+
+### Deprecated: single backend with `OSRM_BACKEND`
+
+`OSRM_BACKEND` is deprecated. It is still supported for backward compatibility and configures exactly one backend named `default`.
+
+```bash
+docker run -p 9966:9966 \
+  -e OSRM_BACKEND='http://localhost:5001' \
+  ghcr.io/project-osrm/osrm-frontend:latest
+```
+
+### Precedence
+
+1. If only `OSRM_BACKEND` is set, the frontend configures one backend and emits a deprecation warning.
+2. If only `OSRM_MODES` is set, the frontend parses the JSON and configures the listed modes.
+3. If both are set, `OSRM_MODES` wins and the frontend emits a deprecation warning for `OSRM_BACKEND`.
 
 In case Docker complains about not being able to connect to the Docker daemon make sure you are in the `docker` group.
 
@@ -28,7 +53,7 @@ sudo usermod -aG docker $USER
 To build the docker image locally:
 
 ```bash
-docker build . -f docker/Dockerfile -t osrm-frontend
+docker build -f docker/Dockerfile -t osrm-frontend .
 docker run -p 9966:9966 osrm-frontend
 ```
 
@@ -56,7 +81,9 @@ npm run start-index
 
 ## Changing Backends
 
-In `src/leaflet_options.js` adjust:
+For Docker deployments, prefer runtime configuration via `OSRM_MODES` instead of editing source files.
+
+For source-level customization, adjust `src/leaflet_options.js`:
 
 ```
 services: [{
 
@@ -25,7 +25,23 @@ RUN npm run build
 
 # Stage 2: serve
 FROM nginx:alpine
+
+# Set runtime environment defaults for entrypoint
+# Note: Default OSRM_BACKEND is localhost:5000 (as documented in README.md:19)
+# Override with -e OSRM_BACKEND='http://...' at runtime
+ENV OSRM_ENVIRONMENT=docker \
+    OSRM_BACKEND=http://localhost:5000 \
+    OSRM_CENTER=38.8995,-77.0269 \
+    OSRM_ZOOM=13 \
+    OSRM_LANGUAGE=en \
+    OSRM_LABEL="Car (fastest)" \
+    OSRM_DEFAULT_LAYER=streets \
+    OSRM_PROFILES=driving,bike,foot
+
 COPY docker/nginx.conf /etc/nginx/conf.d/default.conf
+COPY docker/entrypoint.sh /docker-entrypoint.sh
+RUN chmod +x /docker-entrypoint.sh
+
 # Webpack outputs bundle.js to the project root; copy all static assets
 COPY --from=build /app/index.html /usr/share/nginx/html/
 COPY --from=build /app/favicon.ico /usr/share/nginx/html/
@@ -37,4 +53,7 @@ COPY --from=build /app/fonts /usr/share/nginx/html/fonts
 COPY --from=build /app/images /usr/share/nginx/html/images
 COPY --from=build /app/i18n /usr/share/nginx/html/i18n
 COPY --from=build /app/debug /usr/share/nginx/html/debug
+
 EXPOSE 9966
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["nginx", "-g", "daemon off;"]
@@ -0,0 +1,66 @@
+#!/bin/sh
+set -e
+
+# Default values
+OSRM_BACKEND="${OSRM_BACKEND:-http://localhost:5000}"
+OSRM_CENTER="${OSRM_CENTER:-38.8995,-77.0269}"
+OSRM_ZOOM="${OSRM_ZOOM:-13}"
+OSRM_LANGUAGE="${OSRM_LANGUAGE:-en}"
+OSRM_DEFAULT_LAYER="${OSRM_DEFAULT_LAYER:-streets}"
+OSRM_ENVIRONMENT="${OSRM_ENVIRONMENT:-docker}"
+
+# Validate OSRM_ZOOM is numeric (for valid JSON output)
+case "$OSRM_ZOOM" in
+  ''|*[!0-9-]*|-) OSRM_ZOOM=13 ;;
+esac
+
+# Escape JSON string values (handle quotes, newlines, backslashes)
+escape_json() {
+  printf '%s\n' "$1" | sed 's/\\/\\\\/g; s/"/\\"/g; s/$/\\/' | tr -d '\n' | sed 's/\\$//'
+}
+
+# Load routing modes from the preferred OSRM_MODES config.
+# OSRM_BACKEND is deprecated and only kept as a single-backend fallback.
+MODES_JSON=""
+CONFIG_BACKEND=""
+
+if [ -n "$OSRM_MODES" ]; then
+  # Use the JSON-based mode configuration directly.
+  MODES_JSON="$OSRM_MODES"
+  if [ "$OSRM_BACKEND" != "http://localhost:5000" ]; then
+    CONFIG_BACKEND="$OSRM_BACKEND"
+  fi
+elif [ -f /etc/osrm/modes.json ]; then
+  # Fall back to a mounted JSON file with the same shape as OSRM_MODES.
+  MODES_JSON=$(cat /etc/osrm/modes.json)
+  if [ "$OSRM_BACKEND" != "http://localhost:5000" ]; then
+    CONFIG_BACKEND="$OSRM_BACKEND"
+  fi
+elif [ -n "$OSRM_BACKEND" ] && [ "$OSRM_BACKEND" != "http://localhost:5000" ]; then
+  # Backward compatibility: a non-default OSRM_BACKEND means one deprecated single backend.
+  CONFIG_BACKEND="$OSRM_BACKEND"
+else
+  # With no runtime override, keep the Docker default:
+  # one profile named "default" pointing at http://localhost:5000.
+  MODES_JSON=""
+fi
+
+# Generate config.json with proper JSON escaping
+cat > /usr/share/nginx/html/config.json << EOF
+{
+  "OSRM_BACKEND": "$(escape_json "$CONFIG_BACKEND")",
+  "OSRM_CENTER": "$(escape_json "$OSRM_CENTER")",
+  "OSRM_ZOOM": $OSRM_ZOOM,
+  "OSRM_LANGUAGE": "$(escape_json "$OSRM_LANGUAGE")",
+  "OSRM_DEFAULT_LAYER": "$(escape_json "$OSRM_DEFAULT_LAYER")",
+  "OSRM_ENVIRONMENT": "$(escape_json "$OSRM_ENVIRONMENT")",
+  "OSRM_MODES": "$(escape_json "$MODES_JSON")"
+}
+EOF
+
+# Execute the default command (nginx) or any command passed to the container
+if [ "$#" -eq 0 ]; then
+  exec nginx -g "daemon off;"
+else
+  exec "$@"
+fi
@@ -12,6 +12,55 @@
   </head>
   <body>
     <div id='map' class='map'></div>
-    <script src='bundle.js'></script>
+    <script>
+      // Load runtime configuration (generated by Docker entrypoint from OSRM_* env vars)
+      // Falls back to bundled defaults if config.json is not available
+      // OSRM_ENVIRONMENT indicates execution context: 'docker' or undefined (local dev)
+      window.osrmConfig = {
+        // OSRM_ENVIRONMENT only set to 'docker' if explicitly running in Docker
+        // In all other cases (dev, browser), leave it undefined to use public services
+        OSRM_CENTER: '38.8995,-77.0269',
+        OSRM_ZOOM: 13,
+        OSRM_LANGUAGE: 'en',
+        OSRM_DEFAULT_LAYER: 'streets'
+        // OSRM_BACKEND and OSRM_MODES will be set by config.json if available
+      };
+
+      (function() {
+        function loadBundle() {
+          var script = document.createElement('script');
+          script.src = 'bundle.js';
+          document.body.appendChild(script);
+        }
+
+        function loadConfig() {
+          return new Promise(function(resolve) {
+            fetch('config.json')
+              .then(function(response) {
+                if (!response.ok) {
+                  if (response.status === 404) {
+                    console.warn('config.json not found, using defaults');
+                  } else {
+                    console.warn('Failed to load config.json (HTTP ' + response.status + '), using defaults');
+                  }
+                  resolve();
+                  return;
+                }
+                return response.json()
+                  .then(function(config) {
+                    window.osrmConfig = config;
+                    resolve();
+                  });
+              })
+              .catch(function(error) {
+                console.warn('Failed to load config.json due to a network error, using defaults:', error);
+                resolve();
+              });
+          });
+        }
+
+        loadConfig().then(loadBundle);
+      })();
+    </script>
   </body>
 </html>