Services

TraLa provides several ways to customize how services are displayed, including exclusion, overrides, and manual services.

Service Exclusion

Hide specific services from appearing in the dashboard by specifying router names or entrypoints in your configuration.

Excluding Routers

services:
  exclude:
    routers:
      - "traefik-api"     # Hide the Traefik API itself
      - "admin-panel"     # Hide internal admin interface
      - "api*"            # Hide all routers starting with "api"

Wildcard patterns are supported:

* matches any number of characters
? matches a single character

Excluding Entrypoints

Hide services based on their entrypoint:

services:
  exclude:
    entrypoints:
      - "*lan*"           # Hide services using entrypoints containing "lan"
      - "internal"        # Hide services using the "internal" entrypoint

Service Overrides

Customize display names and icons for your services.

Override Display Name and Icon

services:
  overrides:
    - service: "firefly-core"
      display_name: "Firefly III"
      icon: "https://cdn.jsdelivr.net/gh/selfhst/icons/svg/firefly-iii.svg"
    
    - service: "home-assistant"
      display_name: "Home Assistant"
      icon: "home-assistant.svg"

Override Icon Only

services:
  overrides:
    - service: "plex"
      icon: "plex.webp"
    
    - service: "unknown-service"
      icon: "https://selfh.st/content/images/2023/09/favicon-1.png"

Override with Group Assignment

services:
  overrides:
    - service: "unifi-controller"
      display_name: "UniFi Network"
      icon: "ubiquiti-unifi.svg"
      group: "Network"

Icon File Extensions

When using filenames from the selfh.st icon repository, specify the extension:

.png (default if no extension specified)
.svg
.webp

The application automatically constructs the appropriate URL based on the file extension.

Manual Services

Add custom services that aren’t managed by Traefik.

Basic Manual Service

services:
  manual:
    - name: "Reddit"
      url: "https://www.reddit.com"

Manual Service with Custom Icon

services:
  manual:
    - name: "GitHub"
      url: "https://github.com"
      icon: "github.svg"

Manual Service with Priority

services:
  manual:
    - name: "The Verge"
      url: "https://www.theverge.com"
      icon: "https://www.theverge.com/favicon.ico"
      priority: 100

Configuration Options

Option	Required	Description
`name`	Yes	Display name
`url`	Yes	Service URL
`icon`	No	Custom icon (URL or filename)
`priority`	No	Sort priority (higher = first, default: 50)

Manual services are merged with Traefik-discovered services and use the same icon detection logic.