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:
- Are merged with Traefik-discovered services and displayed together
- Use the same icon detection logic as Traefik services
- 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
- Service config options by @dannybouwers in #40
Full Changelog: v0.6.0...v0.7.0