Configuration Basic Configuration

Basic Configuration

Common DEX settings for routing, capture, and noise control.

This page covers the most common configuration tweaks you’ll make after installing DEX.

If you want the full list of options, see:

Enable / disable DEX

To disable DEX completely:

DEX_ENABLED=false

Change the dashboard route prefix

By default, DEX routes live under /dex.

To move the UI under a different prefix:

DEX_ROUTE_PREFIX=ops/dex

Your dashboard becomes:

/ops/dex/issues

Request IDs

DEX reuses an incoming request ID header (by default X-Request-Id) or generates one if missing. It then writes the request ID back to the response header.

If your infrastructure uses a different header, change it:

DEX_REQUEST_ID_HEADER=X-Correlation-Id

Unhandled exceptions and fatal errors

DEX can capture:

  • Unhandled exceptions (global exception handler)
  • Fatal shutdown errors (E_ERROR, E_PARSE, etc.)

You can disable either behavior:

DEX_CAPTURE_UNHANDLED_EXCEPTIONS=false
DEX_CAPTURE_SHUTDOWN_FATALS=false

Rate limiting noisy issues

If the same exception fires rapidly, DEX rate limits writes per fingerprint:

DEX_MAX_OCCURRENCES_PER_MINUTE=30

Set 0 to disable rate limiting:

DEX_MAX_OCCURRENCES_PER_MINUTE=0

Ignoring routes and traffic you don’t care about

To keep DEX out of certain endpoints:

DEX_IGNORE_PATH_PREFIXES=[\"/health\",\"/metrics\"]

To prevent DEX from tracking its own UI routes:

DEX_IGNORE_SELF_ROUTES=true

Next steps