Sign in
Traefik Discovery

Whether Traefik label discovery is active on this instance, and how to turn it on when it is not.

Changed on
get/traefik-discovery/status

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/traefik-discovery/status
  • Auth: HTTP bearer

Response

Discovery status. configured: false means it is not turned on here — the setup block says exactly how to turn it on

configuredboolean required

true only when the watcher is actually running in this process. false means "not turned on here", never "not supported" — the setup block below always says how to turn it on.

discovered_route_countinteger required

Rows currently in traefik_discovered_routes (all networks).

enabledboolean required

Whether TEMPS_TRAEFIK_DISCOVERY_ENABLED resolved to true. Can be true while configured is false (e.g. Docker unreachable).

enabled_route_countinteger required

Of those, how many are enabled and therefore in the live route table.

networkstring required

Docker network being watched, or the one that would be watched.

poll_interval_secondsinteger required

Interval of the full reconciliation safety net.

reasonstring nullable

Why discovery isn't active, when configured is false.

Example response

{
  "last_reconciliation": {
    "completed_at": "2026-01-01T00:00:00Z"
  },
  "setup": {
    "enable_env_var": "TEMPS_TRAEFIK_DISCOVERY_ENABLED",
    "network_env_var": "TEMPS_TRAEFIK_DISCOVERY_NETWORK"
  }
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status