Server

You can adjust the HTTP server configuration with the following environment variables.

Variables

WUD_SERVER_BASEPATH

Optionalurldefault: /

Base path when running behind a prefix-stripping reverse proxy (e.g., /wud/)

Allowed values:Valid URL path ending with `/`

WUD_SERVER_CORS_ENABLED

Optionalbooleandefault: false

Enable CORS requests

WUD_SERVER_CORS_METHODS

Optionalurldefault: GET,HEAD,PUT,PATCH,POST,DELETE

Allowed CORS HTTP methods

Allowed values:Comma-separated list of valid HTTP verbs

WUD_SERVER_CORS_ORIGIN

Optionalstringdefault: *

Allowed CORS origins

WUD_SERVER_ENABLED

Optionalbooleandefault: true

Whether to expose the HTTP server and REST API

WUD_SERVER_FEATURE_DELETE

Optionalbooleandefault: true

Whether delete operations are permitted via the API and UI

WUD_SERVER_PORT

Optionalintegerdefault: 3000

HTTP listening port

Allowed values:`0` to `65535`

WUD_SERVER_TLS_CERT

Optionalpath

Path to TLS server certificate file (required when TLS is enabled)

Allowed values:File path

WUD_SERVER_TLS_ENABLED

Optionalbooleandefault: false

Enable HTTPS/TLS

WUD_SERVER_TLS_KEY

Optionalpath

Path to TLS server private key file (required when TLS is enabled)

Allowed values:File path

Examples

Disable HTTP server

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    ...
    environment:
      - WUD_SERVER_ENABLED=false

Docker

docker run \
  -e WUD_SERVER_ENABLED=false \
  ...
  getwud/wud

Set HTTP port to 8080

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    ...
    environment:
      - WUD_SERVER_PORT=8080

Docker

docker run \
  -e WUD_SERVER_PORT=8080 \
  ...
  getwud/wud

Run behind a reverse proxy subpath

When WUD is served under a subpath (e.g., https://example.com/wud/) by a prefix-stripping reverse proxy, set WUD_SERVER_BASEPATH to that subpath so the UI and API calls resolve correctly.

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    ...
    environment:
      - WUD_SERVER_BASEPATH=/wud/

Docker

docker run \
  -e "WUD_SERVER_BASEPATH=/wud/" \
  ...
  getwud/wud

Example Caddy configuration (prefix-stripping):

handle_path /wud/* {
    reverse_proxy localhost:3000
}

Enable HTTPS

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    ...
    environment:
      - WUD_SERVER_TLS_ENABLED=true
      - WUD_SERVER_TLS_KEY=/wud_certs/server.key
      - WUD_SERVER_TLS_CERT=/wud_certs/server.crt

Docker

docker run \
  -e "WUD_SERVER_TLS_ENABLED=true" \
  -e "WUD_SERVER_TLS_KEY=/wud_certs/server.key" \
  -e "WUD_SERVER_TLS_CERT=/wud_certs/server.crt" \
  ...
  getwud/wud