Repolode
Submit
bastienwirtz

bastienwirtz/homer

A static, YAML-configured homepage for your server that lists and searches your self-hosted services.

Open-source alternative to:Heimdall

View on GitHubWebsite
Stars
11,681
Forks
927
Open issues
173
Last commit
2 days ago

What is it?

Homer is a static HTML/JS dashboard that displays links to your services as a browsable, searchable homepage. The layout, services, and groups are defined in a single YAML configuration file, so there is no database or backend to maintain.

It is built with Vue and runs as static files behind any HTTP server, and it can be deployed with Docker, from a prebuilt release archive, or built manually with pnpm. Homer also supports smart cards that pull status from services, multiple pages with item grouping, theme customization, and fuzzy search with keyboard shortcuts.

It must be served over HTTP, as opening index.html directly via file:// does not work.

Key features

  • 01Configure services, groups and pages through a single YAML file.
  • 02Fuzzy search with keyboard shortcuts for quick navigation.
  • 03Smart cards that can display live service information.
  • 04Theme customization and installable PWA support.
  • 05Deploy via Docker, Docker Compose, Kubernetes, or a static build.

Use cases

  • Creating a landing page that links to all services on a home server or homelab.
  • Giving a team a shared bookmark dashboard for internal tools.
  • Hosting a lightweight start page in a subfolder behind an existing reverse proxy.

Quick start

  1. 1

    Start the Homer container with Docker

    docker run -d \ --name homer \ -p 8080:8080 \ --mount type=bind,source="/path/to/config/dir",target=/www/assets \ --restart=unless-stopped \ b4bz/homer:latest
  2. 2

    Open the dashboard in your browser at port 8080

Things to know

  • The dashboard must be served over HTTP; opening index.html directly via file:// does not work.
  • Configuration is done by editing a YAML file, so there is no graphical configuration interface.

In collections

Self-hosted appsDashboards & business intelligence tools

Topics

#dashboard#self-hosted#homepage#vuejs#yaml#docker#static-site#hacktoberfest#toolbox

FAQ

What is homer?
A static, YAML-configured homepage for your server that lists and searches your self-hosted services. Homer is a static HTML/JS dashboard that displays links to your services as a browsable, searchable homepage. The layout, services, and groups are defined in a single YAML configuration file, so there is no database or backend to maintain.
Is homer free to use? What license does it have?
homer is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is homer still maintained?
Actively maintained. The last commit to homer was on Oct 21, 2026.
What can I use homer for?
Creating a landing page that links to all services on a home server or homelab. Giving a team a shared bookmark dashboard for internal tools. Hosting a lightweight start page in a subfolder behind an existing reverse proxy.
How do I install homer?
Start the Homer container with Docker: docker run -d \ --name homer \ -p 8080:8080 \ --mount type=bind,source="/path/to/config/dir",target=/www/assets \ --restart=unless-stopped \ b4bz/homer:latest Open the dashboard in your browser at port 8080
Where can I get homer?
The source code and installation instructions are on GitHub: https://github.com/bastienwirtz/homer

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects