Repolode
Enviar
adinhodovic

adinhodovic/compass

Una página de inicio autoalojada que detecta y muestra automáticamente servicios, dashboards y documentos de Docker, Kubernetes y Tailscale.

Ver en GitHubSitio web
Estrellas
78
Forks
4
Issues abiertos
3
Último commit
ayer

¿Qué es?

Compass es una página de inicio para homelabs y entornos autoalojados. En lugar de mantener tarjetas escritas a mano para cada servicio, agregas una fuente en una configuración YAML y Compass muestra lo que esa fuente expone en una interfaz controlada por el servidor.

Entre las fuentes compatibles se incluyen Docker, Kubernetes, Tailscale, Headscale, la configuración estática y los endpoints de JSON API. La interfaz muestra el estado y la actualización de cada fuente, metadatos de los servicios, etiquetas, paneles y vistas de depuración, además de permitir buscar y filtrar servicios.

El frontend genera HTML en el servidor y usa HTMX, Alpine.js, Tailwind y daisyUI. Se puede ejecutar como contenedor Docker o desplegar en Kubernetes con un Helm chart.

Funciones clave

  • 01Detecta servicios automáticamente en Docker, Kubernetes, Tailscale y Headscale.
  • 02Admite fuentes de configuración estática y JSON API.
  • 03Muestra el estado y la actualización de las fuentes.
  • 04Ofrece búsqueda, filtros, etiquetas y metadatos de los servicios.
  • 05Incluye una imagen Docker y un Helm chart para Kubernetes.

Casos de uso

  • Crear un dashboard único para los servicios que se ejecutan en varios hosts Docker de un homelab.
  • Mostrar en un solo lugar los servicios internos de Kubernetes y sus enlaces para un equipo.
  • Explorar desde una sola página los servicios expuestos en una red de Tailscale o Headscale.

Inicio rápido

  1. 1

    Crea compass.yaml con una fuente de Docker

  2. 2

    Ejecuta el contenedor de Compass con Docker

    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
  3. 3

    Para Kubernetes, crea compass.yaml con una fuente de Kubernetes

  4. 4

    Instala Compass con Helm

    helm install compass oci://ghcr.io/adinhodovic/charts/compass -n compass --create-namespace --set-file config=compass.yaml

Antes de usarlo

  • La detección de Docker requiere montar el socket de Docker, lo que concede acceso sensible al host.
  • La detección de Kubernetes depende de los permisos RBAC dentro del clúster que concede el chart de Helm.

En colecciones

Apps autoalojadasPaneles y herramientas de inteligencia de negocioFrameworks de microservicios e infraestructura de servicios

Temas

#dashboard#self-hosted#homelab#service-discovery#docker#kubernetes#tailscale#headscale#homepage#landing-page

Preguntas frecuentes

¿Qué es compass?
Una página de inicio autoalojada que detecta y muestra automáticamente servicios, dashboards y documentos de Docker, Kubernetes y Tailscale. Compass es una página de inicio para homelabs y entornos autoalojados. En lugar de mantener tarjetas escritas a mano para cada servicio, agregas una fuente en una configuración YAML y Compass muestra lo que esa fuente expone en una interfaz controlada por el servidor.
¿compass es gratuito? ¿Qué licencia tiene?
compass es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿compass sigue mantenido?
Mantenimiento activo. El último commit de compass fue el 5 nov 2026.
¿Para qué puedo usar compass?
Crear un dashboard único para los servicios que se ejecutan en varios hosts Docker de un homelab. Mostrar en un solo lugar los servicios internos de Kubernetes y sus enlaces para un equipo. Explorar desde una sola página los servicios expuestos en una red de Tailscale o Headscale.
¿Cómo se instala compass?
Crea compass.yaml con una fuente de Docker Ejecuta el contenedor de Compass con Docker: 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 Para Kubernetes, crea compass.yaml con una fuente de Kubernetes Instala Compass con Helm: helm install compass oci://ghcr.io/adinhodovic/charts/compass -n compass --create-namespace --set-file config=compass.yaml
¿Dónde consigo compass?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/adinhodovic/compass

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados