Skip to content

Dashboard Tab

The Dashboard tab shows all your Traefik routes grouped by category, with app icons, per-card editing, and custom group management.

Enabling the tab

The Dashboard tab is hidden by default. To show it, go to Settings - Interface - Tabs and toggle Dashboard on. You can also enable it during the initial setup wizard. The preference is saved to manager.yml and persists across restarts.


Groups view

Routes are automatically grouped into categories by name - Media, Monitoring, Infrastructure, Security, Home, Files & Data, Network, Dev, Servers, and Other. Each group is a card showing all its routes.

Route rows

Each route row shows:

  • App icon - fetched from the selfh.st icon CDN and cached locally in /config/cache/
  • Name - display name (customisable) or route name, with a TCP/UDP badge when not HTTP
  • Target - backend host:port
  • Security badge - Secure (TLS), Public (plain HTTP entry point), or Internal
  • Complex middleware pills - auth, rate limiting, or custom header middlewares shown as purple pills
  • Security shield pill - infrastructure middlewares (redirect-to-https, HSTS, compression) collapsed into a single green pill with a count

Expand / collapse

Groups with more than 5 routes show only the first 5 by default. Click Show X more at the bottom of the group to expand, and Show less to collapse.


Per-card editing

Click the pencil icon that appears on a route row when you hover it to open the Edit Route modal.

Display name

Override the route name shown in the card. Leave blank to use the original route name.

Icon

Three modes:

  • Auto - icon is auto-detected from the route or service name using the selfh.st CDN
  • selfh.st slug - enter a slug directly (e.g. plex, grafana) - see selfh.st/icons for available icons
  • Custom URL - enter any direct image URL to use as the icon

Icons are fetched once and cached on disk at /config/cache/{slug}.png so they are served locally on subsequent loads.

Group assignment

Override which group the route belongs to. Select Auto-detect to let the keyword matching decide, or pick any built-in or custom group.


Custom groups

Click the tag icon in the filter bar to open the Route Groups modal.

Routes not matched by any built-in category go into Other. Custom groups let you catch specific routes and give them their own card instead.

To add a group: enter a name. Routes are assigned to it via the pencil icon on each route row - select the group in the Group assignment field. Custom groups appear at the top of the group dropdown in the edit modal.

Custom groups are saved to /config/dashboard.yml and persist across restarts.


Group detection

Groups are assigned automatically by matching the route or service name against a built-in keyword list. Routes that do not match any category go into Other.

GroupMatches
Mediajellyfin, sonarr, radarr, immich, qbittorrent, plex, prowlarr, ...
Monitoringgrafana, prometheus, uptime-kuma, glances, speedtest, ...
Infrastructuretraefik, portainer, gitea, n8n, komodo, ...
Securityauthentik, authelia, vaultwarden, crowdsec, wireguard, ...
Homehome-assistant, node-red, esphome, zigbee2mqtt, frigate, ...
Files & Datanextcloud, paperless, mealie, bookstack, syncthing, ...
Networkpihole, adguard, unifi, tailscale, ...
Devgitea, gitlab, forgejo, code-server, coder, drone, jenkins, argocd, harbor, sonar, jupyter, ...
Serversproxmox, cockpit, idrac, ilo, ipmi, truenas, freenas, opnsense, pfsense, unraid, synology, ...
Othereverything else

Filtering

  • Search - type to filter routes by name
  • Protocol - show only HTTP, TCP, or UDP routes
  • Provider - filter by Traefik provider (file, docker, kubernetes, etc.). Only appears when routes from more than one provider are present.

Providers

Routes from all Traefik providers are shown - not just file-based routes. Docker, Kubernetes, Consul Catalog, and other dynamic provider routes appear alongside file routes.

Routes from non-file providers are read-only: the per-card pencil icon lets you customise the display name and icon, but the route config itself (rule, service, entry points) can only be changed through the provider that manages it. The route detail panel's Edit button is hidden for these routes.


Data source

Fetches from:

  • /api/routes - routes from all providers (file-managed + live from Traefik API)
  • /api/traefik/entrypoints - entry point names from the Traefik API
  • /api/dashboard/config - custom groups and per-route overrides from dashboard.yml
  • /api/dashboard/icon/<slug> - app icons (cached from selfh.st CDN)