Skip to content

Headers

The [headers] section configures global request and response header manipulation. Dynamic. It is distinct from:

Per-route header rules under [routes.headers] on each route (same shape as below; applied after global headers)
[security.headers]: HSTS, CSP, and custom security response headers (see Security)
Forwarding: X-Forwarded-* set by the proxy (see Security)

Structure

[headers.request]: add / remove lists
[headers.response]: add / remove lists

Example

YAML
TOML

headers:
  request:
    remove:
      - "X-Forwarded-Server"
    add:
      - name: "X-Proxy-Name"
        value: "huginn-proxy"
  response:
    remove:
      - "Server"
      - "X-Powered-By"
    add:
      - name: "X-Proxy"
        value: "huginn-proxy"

[headers.request]
remove = ["X-Forwarded-Server"]
add = [
    { name = "X-Proxy-Name", value = "huginn-proxy" },
]

[headers.response]
remove = ["Server", "X-Powered-By"]
add = [
    { name = "X-Proxy", value = "huginn-proxy" },
]

See examples/config/compose.toml and compose.yaml on GitHub for complete examples.

Configuration overview