---

name: homepage-services description: Configure services.yaml for Homepage dashboard - service definitions, widgets, Docker integration, icons, and monitoring license: MIT compatibility: opencode metadata: project: homepage type: yaml-config

Homepage services.yaml Configuration

Reference for configuring services in Homepage dashboard.

Structure

Copy---
- GroupName:
    - ServiceName:
        href: http://service.url
        # Additional properties...

Service Properties

Nested Groups

Copy---
- Parent Group:
    - Parent Service:
        href: http://service.url
    - Child Group:
        - Child Service:
            href: http://child.url

Single Widget

Copy- Jellyfin:
    icon: jellyfin.png
    href: http://jellyfin.host:8096
    server: my-docker
    container: jellyfin
    widget:
      type: jellyfin
      url: http://jellyfin.host:8096
      key: { { HOMEPAGE_VAR_JELLYFIN_API_KEY } }
      fields: ["activeStreams", "totalMovies"]

Multiple Widgets

Copy- Jellyfin:
    widgets:
      - type: jellyfin
        url: http://jellyfin.host:8096
        key: { { HOMEPAGE_VAR_JELLYFIN_API_KEY } }
      - type: uptimekuma
        url: http://uptimekuma.host
        slug: jellyfin-status

Widget Properties

Field Visibility

Copy- Sonarr:
    widget:
      type: sonarr
      fields: ["wanted", "queued"]
      url: http://sonarr.host
      key: { { HOMEPAGE_VAR_SONARR_API_KEY } }

Block Highlighting

Copy- Sonarr:
    widget:
      type: sonarr
      url: http://sonarr.host
      key: { { HOMEPAGE_VAR_SONARR_API_KEY } }
      highlight:
        queued:
          numeric:
            - level: danger
              when: gte
              value: 20
            - level: warn
              when: gte
              value: 5
            - level: good
              when: eq
              value: 0

Numeric operators: gt, gte, lt, lte, eq, ne, between, outside String operators: equals, includes, startsWith, endsWith, regex

Icons

Copyicon: sonarr.png           # Dashboard Icons
icon: si-youtube           # Simple Icons
icon: mdi-flask-outline    # Material Design Icons
icon: sh-plex              # selfh.st icons
icon: si-youtube-#a712a2   # Custom color
icon: https://example.com/icon.png  # Remote URL
icon: /icons/custom.png    # Local (mount /app/public/icons)

Docker Integration

Copy- Emby:
    href: http://emby.home/
    server: my-docker # Must match docker.yaml key
    container: emby # Container name
    showStats: true # Show CPU/memory/network

Ping / Site Monitor

Copy- Sonarr:
    ping: sonarr.host # ICMP ping

- Radarr:
    siteMonitor: http://radarr.host/ # HTTP HEAD/GET

Common Patterns

Media Service with Widget

Copy- Jellyfin:
    href: http://jellyfin.host:8096
    icon: jellyfin.png
    server: Unraid
    container: jellyfin
    showStats: true
    widget:
      type: jellyfin
      url: http://jellyfin.host:8096
      key: { { HOMEPAGE_VAR_JELLYFIN_API_KEY } }
      enableBlocks: true
      enableNowPlaying: true

Torrent Client

Copy- Transmission:
    href: http://transmission.host:9091
    server: Unraid
    container: transmission
    widget:
      type: transmission
      url: http://transmission.host:9091
      username: { { HOMEPAGE_VAR_TRANSMISSION_USERNAME } }
      password: { { HOMEPAGE_VAR_TRANSMISSION_PASSWORD } }
      fields: ["leech", "download", "seed", "upload"]

Simple Link (No Widget)

Copy- LocalAI:
    href: http://localai.host:8082
    icon: mdi-robot
    description: Local LLM server