Star 历史趋势
数据来源: GitHub API · 生成自 Stargazers.cn
README.md

Compass

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

Getting started · Docs · Demo

Compass services dashboard

Why Compass

Add a source and Compass renders what is exposed in a server-driven UI with source status, tags, metadata, and operator context. Search, filter, debug, and jump into services without maintaining a pile of hand-written cards.

  • Docker, Kubernetes, Tailscale, Headscale, NetBird, static config, and JSON API sources.
  • Source health, refresh status, service metadata, panels, tags, and debug views.
  • Up/down status on service cards from Prometheus, Gatus, or any JSON endpoint you already run.
  • Server-rendered HTML with HTMX, Alpine.js, Tailwind, and daisyUI.

Quick start

Docker source compass.yaml:

organization:
  name: Homelab

services:
  sources:
    - type: docker
      name: local
# Add the host's docker GID so the non-root container user can read the socket. Alternatively use: tecnativa/docker-socket-proxy
docker run --rm -p 8080:8080 \
  --group-add $(getent group docker | cut -d: -f3) \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v $PWD/compass.yaml:/etc/compass/compass.yaml:ro \
  adinhodovic/compass:latest \
  -c /etc/compass/compass.yaml

Kubernetes source compass.yaml:

organization:
  name: Homelab

services:
  sources:
    - type: kubernetes
      name: cluster # Helm grants in-cluster RBAC for discovery
      kubernetes:
        namespaces: []
helm install compass oci://ghcr.io/adinhodovic/charts/compass -n compass --create-namespace --set-file config=compass.yaml

See Getting started for a minimal config and source examples.

关于 About

A landing page for your services, dashboards, and documents, discovered automatically from sources such as Docker, Kubernetes, Tailscale and Netbird.
dashboarddockerheadscalehomelabhomepagekuberneteslanding-pageself-hostedservice-catalogservice-discoverytailscaletoolbox

语言 Languages

Go78.5%
HTML15.5%
JavaScript3.4%
TypeScript1.1%
Go Template0.7%
Makefile0.4%
Dockerfile0.3%
CSS0.1%

提交活跃度 Commit Activity

代码提交热力图
过去 52 周的开发活跃度
171
Total Commits
峰值: 41次/周
Less
More

核心贡献者 Contributors