github dannybouwers/trala v0.7.0
v0.7.0: BREAKING CHANGES - More override options

2 days ago

Warning

Breaking changes - update your configuration file

🚀 More override options

This release gives you more power over the dashboard. You can now override the names of services. You can also manually add services not managed by Traefik. The only downside: I had to make some breaking changes to the config file. (Fortunately, the app will check compatibility and warn you!)

How to fix?

The section icons: isn't part of the config file anymore. It's moved to services:. You can just copy-paste it since the structure is fully compatible. Once moved, change the version number to version: 2.0.

Display name override

You can override the service name using the attribute display_name. This name will be shown in the frontend and will be used to search for icons.

Example

# TraLa Configuration File
# Version 2.0

version: 2.0

# Service configuration
services:
  # Service overrides for display names and icons
  overrides:
    # Override both display name and icon
    - service: "firefly-core"
      display_name: "Firefly III"
      icon: "https://cdn.jsdelivr.net/gh/selfhst/icons/svg/firefly-iii.svg"

Manual Services

Sometimes you want to add services to your dashboard that aren't managed by Traefik - like external websites, cloud services, or resources hosted elsewhere. TraLa allows you to manually add these services through the configuration file.

How It Works

Manual services are defined in the manual section of your configuration.yml file. These services:

  1. Are merged with Traefik-discovered services and displayed together
  2. Use the same icon detection logic as Traefik services
  3. Support all icon options (auto-detection, custom icons, etc.)

Configuration Options

Each manual service can include:

  • name: The display name (required)
  • url: The URL of the service (required)
  • icon: Custom icon (optional - full URL or filename from selfh.st)
  • priority: Priority for sorting (optional - higher numbers appear first, default: 50)

Example

# TraLa Configuration File
# Version 2.0

version: 2.0

# Service configuration
services:
  # Manually added services (not from Traefik)
  manual:
    # Basic manual service with just name and URL
    - name: "Reddit"
      url: "https://www.reddit.com"
    
    # Manual service with custom icon
    - name: "GitHub"
      url: "https://github.com"
      icon: "github.svg"
    
    # Manual service with icon and priority
    - name: "The Verge"
      url: "https://www.theverge.com"
      icon: "https://www.theverge.com/favicon.ico"
      priority: 100
    
    # Manual service with just name, URL, and priority (icon will be auto-detected)
    - name: "Hacker News"
      url: "https://news.ycombinator.com"
      priority: 90

What's Changed

Full Changelog: v0.6.0...v0.7.0

Don't miss a new trala release

NewReleases is sending notifications on new releases.