homer

A very simple static homepage for your server.

⭐ 11,319 stars on GitHub · 🍴 904 forks · 📜 License: apache-2.0 · 💻 Language: Vue

What is homer?

A fast server homepage should be boring in the best way: easy to deploy, easy to edit, and reliable enough to forget about. Homer nails that by staying fully static and driving the whole dashboard from a simple YAML file.

Main components

• Static HTML/JavaScript dashboard built with Vue, served by any basic web server
• YAML-based configuration for links, groups, pages, themes, and service metadata
• Docker image with bind-mounted config for quick self-hosted deployment
• Multi-page layouts and item grouping for organizing many internal services
• Smart cards for richer service tiles beyond plain bookmarks
• Fuzzy search plus keyboard shortcuts for fast navigation
• Theme customization, icons, favicons, and PWA install support

Clear use cases

• Build a clean landing page for a homelab with links to Proxmox, Grafana, Jellyfin, Home Assistant, and NAS tools
• Give a small ops team one internal portal for monitoring, admin panels, runbooks, and staging apps
• Replace a browser bookmark mess with a version-controlled config.yml
• Publish a lightweight dashboard behind Tailscale, WireGuard, VPN, or a reverse proxy
• Create separate pages for personal services, infrastructure tools, customer environments, or team resources

The biggest strength is simplicity without feeling primitive — Homer avoids databases, login systems, backend services, and heavy dashboard abstractions, so there is very little to break. Compared with commercial portal or intranet tools, its value is that you can run it as static files, keep the config in Git, deploy it with Docker or any HTTP server, and update your service catalog with one YAML edit.

Homer is not trying to be an observability platform or a full service catalog. It will not replace Grafana, Backstage, Heimdall-style integrations, or an enterprise SSO-backed app directory. But for many self-hosted setups, that restraint is exactly the point: you get a polished homepage that loads quickly, looks good, and does the job without dragging in operational complexity.

Configuration is approachable, especially if you already manage infrastructure as code. The Docker setup is also practical: mount your assets directory, expose port 8080, and you have a working dashboard. The only real gotcha is that it must be served over HTTP; opening index.html directly via file:// is not supported.

The UI features are small but useful. Fuzzy search and / keyboard activation make it quick to jump to services, while grouping and multiple pages keep larger homelabs from turning into a wall of tiles. PWA support is a nice bonus if you want the dashboard pinned on a phone or workstation.

Best for homelab owners, sysadmins, and small teams who want a low-maintenance self-hosted service homepage managed from YAML.

Topics: the project is tagged with popular topics:

• 🏷️ dashboard
• 🏷️ hacktoberfest
• 🏷️ homepage
• 🏷️ self-hosted
• 🏷️ toolbox
• 🏷️ vuejs

📸 Screenshots

Quick install

See the README for detailed install instructions. Most projects support Docker — if the repo has a Dockerfile, use:

git clone https://github.com/bastienwirtz/homer.git
cd homer
docker build -t homer .
docker run -d -p 8080:8080 homer

Minimum system requirements

⚡ Deploy fast on VSIS

Use the VSIS VPS Mini 1GB RAM / 1 vCPU / 15GB SSD (~70k/tháng) plan from VSIS.NET — high-speed VN-based VPS, 24/7 support, ideal for running homer smoothly.

🎯 Benefits:

• One-command docker compose up -d deploy in 2 minutes
• Dedicated IPv4, root access, unmetered domestic bandwidth
• Daily snapshot backup
• Free install assistance from the VSIS team

👉 See matching VPS plans at vsis.net

Resources

• 🔗 GitHub: bastienwirtz/homer
• 🌐 Homepage: https://homer-demo.netlify.app/
• 📚 Official docs: see README in the repo
• 💬 Community: GitHub Issues + Discussions

Article compiled from GitHub data on 05/05/2026. Star/fork counts may have changed — see live numbers via the GitHub link.