# Homer

Homer is a lightweight, self-hosted dashboard that displays your home lab services as a simple, static homepage you can fully customize with a single YAML config file. It is open source and self-hosted, installable on Docker Hub, Proxmox, Kubernetes (Helm), ZimaOS, TrueNAS and Unraid.

Canonical page: https://ourlocalhost.com/app/397/homer

## Description

Homer is a lightweight, self-hosted dashboard that displays your home lab services as a simple, static homepage you can fully customize with a single YAML config file.

## Platform availability

Available on 5 of 9 platforms: Unraid, TrueNAS, ZimaOS, Proxmox, Helm.

## Health score

25/100 (Low), based on 2 of 4 factors.
- Maintained: 0 (GitHub repository no longer exists)
- Easy to install: 75 (5 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/b4bz/homer/
- GitHub: https://github.com/b4bz/homer
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=homer
- Kubernetes (Helm): https://artifacthub.io/packages/helm/gabe565/homer
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/homer
- TrueNAS: https://apps.truenas.com/catalog/homer/
- Unraid: https://ca.unraid.net/apps/homer-11kyg1w06thoog?q=homer

## Common questions

### Why won't Homer load when I open it as a local file?

Homer needs to be served over HTTP by a web server because it uses HTTP to fetch its files. Opening it through file:// will not work.

### Which file should I back up after configuring my Homer dashboard?

The dashboard settings are in assets/config.yml, including the title, logo, columns, and service cards. Keep a backup of that file after you configure it.

### What should I check if my Docker deployment of Homer is failing?

The troubleshooting documentation lists Docker deployment problems as a common issue area.

### What can cause Smart Card problems in Homer?

The troubleshooting documentation points to CORS issues with Smart Cards.

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