adinhodovic

adinhodovic / compass

Public

A landing page for your services, dashboards, and documents, discovered automatically from sources such as Docker, Kubernetes, and Tailscale.

adinhodovic.github.iocompass docker dsahboard headscale homelab kubernetes
37
0
69% credibility
Found May 17, 2026 at 37 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Go
AI Summary

Compass is a free, open-source dashboard that automatically discovers all the services running in your homelab or personal infrastructure. It connects to sources like Docker containers, Kubernetes clusters, Tailscale networks, and custom APIs, then presents everything in a clean, searchable web interface. You configure it once with a simple list of where to look, and Compass keeps itself updated. It includes search, tagging, embedded monitoring panels, personal favorites, and optional pages you can write in simple markdown.

How It Works

1
🔍 You discover a scattered homelab

You've been running services for years — Grafana here, Pi-hole there, apps on your private network, maybe some Tailscale nodes. Finding anything requires digging through bookmarks and remembering which port is which.

2
✨ You find Compass

A free tool that automatically finds all your services from Docker, Kubernetes, Tailscale, and more, and builds a beautiful dashboard without you typing each one by hand.

3
📝 You write a simple list

In one small configuration file, you tell Compass where your services live — your Docker socket, your Kubernetes cluster, your Tailscale network. No code needed.

4
🚀 You click to launch

Compass runs as a simple web application on your network. You open your browser and your services are already there — icons, descriptions, clickable links, all organized.

5
🔎 You search and explore

Type to find anything instantly, filter by tags like 'monitoring' or 'network', click into any service to see dashboards, links, and notes. Everything stays fresh automatically.

6
📌 You pin your favorites

Keep your most-used services at the top, add personal notes to any service, even embed live charts from Grafana directly into your pages.

🎉 Your homelab has a home

One place where every service is discoverable, documented, and just a click away. No more hunting through scattered bookmarks — everything is organized and always up to date.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 37 to 37 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is compass?

Compass is a self-hosted landing page that automatically discovers and organizes your services from Docker, Kubernetes, Tailscale, and other infrastructure sources. You point it at your cluster or Docker socket, and it renders a searchable dashboard of service cards with icons, URLs, status, and embedded Grafana panels—no manual YAML maintenance required. Built in Go with server-rendered HTML, HTMX, and Alpine.js, it ships as a single binary and requires no frontend build step or client-side SPA runtime.

Why is it gaining traction?

The key hook is zero-effort discovery: Compass reads container labels, Kubernetes ingress annotations, and Tailscale devices to build its dashboard automatically. When you spin up a new service in Docker Compose or deploy to k3s, Compass picks it up on the next refresh without any config changes. It also solves the "doc link rot" problem that plagues static dashboards by pulling metadata from a built-in catalog of 200+ common services. The markdown pages feature with `[[wiki-links]]` and Grafana panel shortcodes makes runbooks and service documentation actually useful, with live links back to the services they describe.

Who should use this?

Homelab enthusiasts running Docker Compose or k3s who are tired of maintaining static YAML dashboards. Platform teams wanting a lightweight internal service catalog that ties into their existing cluster and monitoring stack. DevOps engineers managing multiple environments who need a quick way to surface running services with health checks and Grafana embeds. Small teams without a dedicated internal developer portal who want a zero-friction way to organize their tooling without building something custom.

Verdict

Compass is well-built and genuinely useful for homelab and small-team use cases, with solid test coverage and a working dev environment. However, the credibility score of 0.70% and 37 stars reflect a very early-stage project with limited community adoption—production use in larger orgs would benefit from more battle-testing and user feedback. Worth trying for homelab deployments; hold off on enterprise adoption until the star count and real-world usage grow.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.