git404hub

what is homer fr?

bastienwirtz/homer — explained in plain English

Analysis updated 2026-06-24

11,342VueAudience · ops devopsComplexity · 2/5LicenseSetup · easy

tl;dr

Homer is a simple home server dashboard that shows all your self-hosted services in one page, driven by a single YAML config file, no database, no backend, just a static page served by Docker or any web server.

vibe map

mindmap
  root((homer))
    What it does
      Home server dashboard
      Service link organizer
      Fuzzy search
    Config
      YAML file
      Theme options
      Smart cards
    Deployment
      Docker container
      Static web server
      Kubernetes
    Audience
      Self-hosters
      Home lab users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Set up a single dashboard page for all your self-hosted services like media servers, password managers, and file sync tools

VIBE 2

Organize home server bookmarks into sections with icons and fuzzy search across all listed services

VIBE 3

Deploy a lightweight home lab dashboard with a single Docker container and a YAML config file

VIBE 4

Add smart status cards that pull live metadata or health status from supported services

what's the stack?

VueJavaScriptYAMLDocker

how it stacks up fr

bastienwirtz/homerzyronon/douyinchaitin/xray
Stars11,34211,44311,557
LanguageVueVueVue
Setup difficultyeasyeasyeasy
Complexity2/53/52/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
Use freely for any purpose including commercial, as long as you keep the copyright notice and state any changes made.

in plain english

Homer is a Vue-based project that creates a simple dashboard page for a home server or self-hosted setup. Instead of bookmarking every service you run, like a media server, password manager, or file sync tool, you point a browser at Homer and see all your links in one organized place. The whole dashboard is driven by a single YAML configuration file. You list your services, group them into sections, add icons, and configure links. Homer reads that file and generates the page. No database is required and no backend logic runs at request time. It is a static HTML and JavaScript site that just needs a basic web server to deliver the files. Deployment is straightforward. The most common approach is Docker: you run a single container and mount a local directory that holds your config file. The README also covers running it without Docker by downloading a prebuilt ZIP and serving it with any static web server, including Python's built-in one for quick testing. A separate documentation page covers Kubernetes installation for those who need it. Features include fuzzy search across all your listed services, keyboard shortcuts for navigating and opening results, multi-page support for larger setups, theme customization, and what the project calls smart cards. Smart cards can pull live status or extra metadata from certain supported services. Full details for each feature are in separate documentation pages linked from the README. Homer is licensed under Apache 2.0 and appears in the Awesome Self-Hosted curated list. The project emphasizes staying lightweight and requiring minimal ongoing maintenance once your configuration file is set up.

prompts (copy fr)

prompt 1
I'm setting up a Homer home server dashboard. Help me write a config.yml that groups my services into Media, Files, Security, and Monitoring sections, with at least 3 services per group including icons and URLs.
prompt 2
I want to add a smart card to my Homer dashboard for a Proxmox server. What YAML config format should I use and what does Homer display from it?
prompt 3
Show me how to enable fuzzy search and keyboard shortcuts in Homer's config.yml so I can quickly jump to any service from the dashboard.
prompt 4
I want to deploy Homer using Docker on my home server. Give me the Docker run command and the minimum folder structure for the config directory.

Frequently asked questions

what is homer fr?

Homer is a simple home server dashboard that shows all your self-hosted services in one page, driven by a single YAML config file, no database, no backend, just a static page served by Docker or any web server.

What language is homer written in?

Mainly Vue. The stack also includes Vue, JavaScript, YAML.

What license does homer use?

Use freely for any purpose including commercial, as long as you keep the copyright notice and state any changes made.

How hard is homer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is homer for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.