traefik/docs/content/operations/dashboard.md
Manuel Zapf e7033071b9 change docs and adjust dashboard for v2 alpha
Co-authored-by: Jean-Baptiste Doumenjou <jb.doumenjou@gmail.com>
2019-03-19 17:54:10 +01:00

2 KiB

The Dashboard

See What's Going On {: .subtitle }

The dashboard is the central place that shows you the current active routes handled by Traefik.

??? note "Dashboard WIP" Currently, the dashboard is in a Work In Progress State while being reconstructed for v2. Therefore, the dashboard is currently not working.

Dashboard - Providers
The dashboard in action with Traefik listening to 3 different providers
Dashboard - Health
The dashboard shows the health of the system.

By default, the dashboard is available on / on port :8080.

!!! tip "Did You Know?" It is possible to customize the dashboard endpoint. To learn how, refer to the Traefik's API documentation(TODO: add doc and link).

Enabling the Dashboard

To enable the dashboard, you need to enable Traefik's API.

??? example "Using the Command Line"

| Option          | Values          |         Default Value |
| --------------- | --------------- | --------------------: |
| --api           | \[true\|false\] |                 false |
| --api.dashboard | \[true\|false\] | true when api is true |

{!more-on-command-line.md!}

??? example "Using the Configuration File"

```toml
[api] 
  # Dashboard
  #
  # Optional
  # Default: true
  #
  dashboard = true
```

{!more-on-configuration-file.md!}

??? example "Using a Key/Value Store"

| Key           | Values          |         Default Value |
| ------------- | --------------- | --------------------: |
| api           | \[true\|false\] |                 false |
| api.dashboard | \[true\|false\] | true when api is true |

{!more-on-key-value-store.md!}

!!! tip "Did You Know?" The API provides more features than the Dashboard. To learn more about it, refer to the Traefik's API documentation(TODO: add doc and link).