Homer#

Homer is a static, YAML-configured service dashboard. It renders a single landing page of grouped tiles linking to the other services on the network. It runs on ereshkigal, where it is enabled on port 88.

Configuration#

A host enables the dashboard with tsunaminoai.homer.enable = true;. The module wires up the upstream services.homer and an Nginx virtual host to serve it.

Key options under tsunaminoai.homer:

  • enable — expose the dashboard on this host.
  • port — TCP port Nginx listens on. Defaults to 8080; ereshkigal overrides it to 88.
  • links — declarative list of top-bar link tiles (typed name / url / icon / target submodule). Appended to the built-in links.
  • services — list of dashboard groups, each with a name and a list of items (tiles). Host- and module-supplied groups are merged by group name.
  • extraOptions — extra top-level Homer settings merged into the config (ereshkigal uses this for a work-in-progress banner message).
  • openFirewall — open port in the firewall (default true).
  • hostName — the Nginx virtual host name (default localhost).

The base config sets the title “FalseBlue DashBoard”, a three-column layout, and built-in top-bar links (Docs, Unifi Console, Git Repo, Status Page).

How tiles are contributed#

The services lists from multiple sources are merged by group name: tiles defined in the host config, the module’s built-in voileServices and HA_services, and a self-referential “Homer” tile the module injects. Groups with the same name have their items concatenated, and groups are sorted into a preferred order: Media, Media Acquisition, Home Assistant Services, Admin, Other.

Reverse proxy and TLS#

Nginx fronts the dashboard. When step-ca ACME is enabled (tsunaminoai.pki.acme.enable), the virtual host is configured onlySSL using the host’s ACME certificate, listening on port over HTTPS; the injected Homer self-tile also switches its URL to https://. Otherwise Nginx listens on port over plain HTTP.

Built-in groups and tiles#

The module ships several groups in addition to host-defined ones:

  • Media — Komga and LanRaragi (both on voile). See media.
  • Home Assistant Services — Home Assistant, Uptime Kuma, and AdGuard, all on the HA Green appliance at 192.168.0.55.
  • Admin — Synology DSM, BorgWarehouse, and Minio on voile.
  • Other — Gitea (pointing at voile:8418), Kiwix, TaskChampion, plus the auto-injected Homer self-link.