Homer

Homer is an open-source, self-hosted application that provides a static homepage for servers. It organizes services and links into a centralized dashboard based on a YAML configuration file. The application serves as a launcher for various network services, allowing users to keep their most used tools and bookmarks in one location for quick access across a local network.

Deployment occurs via an HTTP server, with official support for Docker and Docker Compose. It can also be deployed by extracting a prebuilt release tarball and serving the resulting files through any standard web server. Because it is a static HTML and JavaScript application, it requires a server environment to function and cannot be run by opening the index file directly via the file protocol.

Key features

• Configuration via a simple YAML file
• Fuzzy search for quick link navigation
• Support for multiple pages and item grouping
• Theme customization options
• Keyboard shortcuts for searching and opening links
• Progressive Web App (PWA) installation
• Smart cards for service organization

The software is built with Vue.js and is designed for low maintenance. It includes specific environment variables to handle subfolder hosting, internal port configuration, and the initialization of example assets. The architecture relies on a bind-mounted configuration directory in Docker setups, which ensures that changes to the YAML file are reflected on the dashboard without requiring a full rebuild of the container. Users can manage their assets, such as favicons and configuration files, directly within the mapped directory to maintain a consistent layout.

For those who prefer manual setups, the project allows for building from source using pnpm. This process generates a distribution directory containing the final HTML and JS files. The system is designed to be lightweight, requiring minimal system resources to serve the static content to connected clients.

Homer is a lightweight tool for users who need a simple, static directory of links for their home lab or server environment.