feature: allow a configurable backend address

docker-compose.dev.yml

@@ -31,6 +31,8 @@ services:
     ports:
       - "8001:80"
     restart: unless-stopped
+    environment:
+      BACKEND_ADDR: http://backend:8000
 
   mailpit:
     image: axllent/mailpit:latest

docker-compose.e2e.yml

@@ -35,6 +35,8 @@ services:
     depends_on:
       backend:
         condition: service_healthy
+    environment:
+      BACKEND_ADDR: http://backend:8000
 
   test-runner:
     build:

docker-compose.yml

@@ -17,3 +17,5 @@ services:
     ports:
       - "8001:80"
     restart: unless-stopped
+    environment:
+      BACKEND_ADDR: http://backend:8000

docs/guide/configuration.md

@@ -105,11 +105,19 @@ To opt out entirely:
 TELEMETRY_DISABLED=true
 ```
 
-## Frontend Build
+## Frontend
 
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `PUBLIC_DEFAULT_LOCALE` | Default UI language (`en`, `de`, `zh`, `es`, or `fr`) | `en` |
+### Run Time
+
+| Variable       | Description                                                                                                                        |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `BACKEND_ADDR` | Configures the upstream address for the Nginx webserver. For the default `docker-compose.yml` this is set to `http://backend:8000` |
+
+### Build Time
+
+| Variable                | Description                                           | Default |
+| ----------------------- | ----------------------------------------------------- | ------- |
+| `PUBLIC_DEFAULT_LOCALE` | Default UI language (`en`, `de`, `zh`, `es`, or `fr`) | `en`    |
 
 ## Import Limits
 

frontend/Dockerfile

@@ -17,5 +17,5 @@ RUN npm run build
 # Stage 2: serve
 FROM nginx:alpine
 COPY --from=builder /app/build /usr/share/nginx/html
-COPY nginx.conf /etc/nginx/conf.d/default.conf
+COPY nginx.conf.template /etc/nginx/templates/default.conf.template
 EXPOSE 80

frontend/nginx.conf → frontend/nginx.conf.template

@@ -7,7 +7,7 @@ server {
 
     # API proxy to backend service inside docker network.
     location /api/ {
-        proxy_pass http://backend:8000;
+        proxy_pass ${BACKEND_ADDR};
         proxy_http_version 1.1;
         proxy_set_header Host $http_host;
         proxy_set_header X-Real-IP $remote_addr;