labby
Labby es un dashboard auto-alojado para homelabs, construido con Bun y Svelte 5. Ofrece widgets en tiempo real vía SSE, gestión de contenedores Docker y configuración centralizada en SQLite sin archivos planos.
Ficha actualizada 18 sept 2026, 21:01 · upstream 11 sept 2026, 23:58 · release v1.9.0
Qué es labby
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Labby es una interfaz web ligera diseñada para monitorear y gestionar un homelab desde un único proceso Bun. Utiliza Svelte 5 para el frontend y Hono para la API backend, comunicándose a través de canales SSE (Server-Sent Events) para actualizaciones en tiempo real sin polling del cliente. La configuración y credenciales se almacenan íntegramente en una base de datos SQLite local (`config/labby.db`), validada con Zod y gestionada mediante migraciones automáticas.
- Monitorización unificada de servicios como Jellyfin, Plex, qBittorrent o AdGuard Home desde una sola vista.
- Control interactivo de contenedores Docker (iniciar, detener, reiniciar) directamente desde el dashboard.
- Gestión de descargas con widgets para SABnzbd, Transmission y Radarr/Sonarr mostrando progreso y logs.
- Visualización de métricas en tiempo real como velocidad de red, clima o noticias de Hacker News/Reddit.
- Ahorro de recursos al ejecutar todo el stack (API + Frontend) en un único contenedor con Bun.
- Arquitectura monolítica ligera: un solo contenedor Docker ejecuta tanto la API como el frontend SPA.
- Actualizaciones en tiempo real mediante SSE, eliminando la necesidad de polling constante del navegador.
- Configuración persistente y editable directamente desde la interfaz web sin tocar archivos externos.
- Soporte nativo para múltiples instancias de servicios (ej. dos Radarr) con canales SSE independientes.
- Iconografía flexible soportando iconos Lucide, iconos personalizados o URLs externas.
- No incluye autenticación ni control de acceso; debe protegerse obligatoriamente detrás de un proxy inverso en LAN/VPN.
- El acceso al socket Docker (`unix:///var/run/docker.sock`) otorga permisos equivalentes a root sobre el daemon.
- La base de datos SQLite reside en volumen local, por lo que requiere gestión manual de copias de seguridad.
- Dependencia del runtime Bun para la construcción y ejecución, aunque se empaqueta como imagen Docker.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue recomendado mediante `docker-compose.yml`. Asegurar que el volumen `config/` sea legible por el usuario interno del contenedor (UID/GID) para evitar errores de escritura en SQLite. Nunca exponer la interfaz a internet sin proxy inverso y firewall restringido. Para control Docker seguro, usar `docker-socket-proxy` TCP con permisos limitados en lugar del socket Unix directo.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.