As self-hosted services multiply across multiple servers, remembering arbitrary port numbers and subdomains becomes unmanageable for homelab administrators and family members.
Modern homelabs deploy declarative, real-time application dashboards such as Homepage or Dashy, offering automated health checks, Docker socket integration, and live resource widgets.
⚡ Quick Runbook: 60-Second Implementation
TL;DR: Copy and deploy the baseline production definition directly onto your host:
# /opt/stacks/homepage/config/services.yaml
- Infrastructure:
- TrueNAS Core:
icon: truenas.png
href: https://truenas.example.com
description: ZFS Storage & File Server
widget:
type: truenas
url: https://truenas.example.com
key: "{{HOMEPAGE_VAR_TRUENAS_KEY}}"
- Komodo Orchestrator:
icon: docker.png
href: https://komodo.example.com
description: GitOps Container Deployment Engine
1. Declarative Dashboard Configuration
Unlike database-backed bookmark portals, modern dashboards use version-controlled YAML configuration files that integrate seamlessly into GitOps workflows:
# /opt/stacks/homepage/config/services.yaml
- Infrastructure:
- TrueNAS Core:
icon: truenas.png
href: https://truenas.example.com
description: ZFS Storage & File Server
widget:
type: truenas
url: https://truenas.example.com
key: "{{HOMEPAGE_VAR_TRUENAS_KEY}}"
- Komodo Orchestrator:
icon: docker.png
href: https://komodo.example.com
description: GitOps Container Deployment Engine
Related Runbooks in This Series
- Modern Media Streaming: Jellyfin on Docker with Intel QuickSync & NVIDIA Hardware Transcoding
- Production Photo & Video Management: Deploying Immich with ML Acceleration on OpenZFS
- Smart Home Infrastructure: Containerized Home Assistant, Zigbee2MQTT, and Matter
- Homelab Status Dashboards: Modern Service Portals with Homepage and Dashy
- Zero-Downtime Container Healthchecks, Auto-Healing & Safe Update Strategies