# Homelabdash

Homelabdash is a self-hosted monitoring & logging app. A self-hosted dashboard for your homelab, configured in one YAML file. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7029/homelabdash

## Description

A self-hosted dashboard for your homelab, configured in one YAML file. Edit /config/homelabdash.yaml and the page follows every save; the first start writes a starter file to begin from. Tiles update live, can graph their last hour, and raise alerts you can dismiss. 16 plugins come built in, among them Tautulli, the arrs, Seerr, qBittorrent, SABnzbd, Docker, Unraid, apcupsd, AdGuard Home and OpenWrt, and you can write your own. There is no login by default, so keep it on your LAN or put it behind a reverse proxy that signs you in.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 1 day ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/homelabdash-1e871hp1jbq0e1?q=homelabdash
- GitHub: https://github.com/xiaodoudou/homelabdash

## Common questions

### Where do I edit the dashboard configuration and does it hot reload?

You edit /config/homelabdash.yaml, and the page follows every save. On first start, homelabdash writes a starter file to begin from.

### Do I put API keys and passwords in the main YAML file?

Keys and passwords should go in config/secrets.yaml and be referenced in the main config. They never reach the browser.

### How can I check my configuration before it causes problems?

Run homelabdash validate to check the whole folder and print each problem as file:line path: message. If a change is invalid, the last good config keeps running.

### Does homelabdash have built-in login?

There is no login by default. Keep it on your LAN or put it behind a reverse proxy that signs you in.

### How are live tile updates delivered?

The server polls each service on its own interval and pushes changes over a WebSocket. A service is fetched once even if multiple tiles show it.

---
Source: Our Local Host (https://ourlocalhost.com/app/7029/homelabdash), the self-hosted and open-source app directory.