jellarr
Motor de configuración declarativa para Jellyfin que aplica y sincroniza ajustes del servidor mediante archivos YAML versionados usando la API REST oficial, evitando manipulación directa de bases de datos.
Ficha actualizada 18 sept 2026, 21:28 · upstream 15 ago 2026, 2:00 · release v0.1.0
Qué es jellarr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Jellarr es una herramienta open-source diseñada para simplificar la gestión de configuración declarativa en servidores Jellyfin. Inspirado en el enfoque de Configarr para automatización de stacks *arr, utiliza la API REST oficial de Jellyfin para aplicar cambios de configuración de forma segura a través de archivos YAML versionados.
El proyecto aborda problemas comunes en la administración de Jellyfin a escala: deriva de configuración entre entornos (dev/staging/prod), falta de control de versiones para cambios de ajustes, intervención manual no escalable y ausencia de automatización en flujos de trabajo como código. A diferencia de soluciones anteriores que manipulaban directamente archivos XML o bases de datos SQLite, Jellarr opera exclusivamente a través de la API oficial.
La herramienta soporta despliegue mediante Nix Flake (recomendado), Docker Compose y descargas binarias directas. Incluye capacidades para gestión de plugins, configuración de codificación hardware, administración de usuarios con integración segura a sops-nix, y exportación experimental de configuraciones existentes.
- Gestión de configuración multi-entorno (dev/staging/prod) con control de versiones
- Automatización de despliegues mediante IaC (NixOS, Docker Compose)
- Sincronización de configuraciones entre múltiples instancias de Jellyfin
- Mantenimiento de consistencia en flotas de servidores multimedia
- Enfoque API-based que garantiza cero interrupciones de servicio durante la configuración
- Soporte cross-platform independiente de NixOS (Docker, bare metal, cualquier OS)
- Tipado seguro con OpenAPI para detección temprana de errores en tiempo de compilación
- Diseño idempotente para ejecución segura vía cron o systemd timers
- Dependencia crítica de Node.js 24+ para ejecuciones binarias directas, excluyendo entornos legacy
- Funcionalidad de bootstrap de API Key solo funciona en despliegues monolíticos compartiendo host con Jellyfin
- Exportación experimental de configuración existente podría introducir inconsistencias sin revisión manual
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.
Recomendado usar Nix Flake para integración nativa con sops-nix. En Docker, montar volumen de configuración en modo read-only y establecer JELLARR_API_KEY correctamente. Evitar campos plaintext password en producción; preferir passwordFile con gestión de secretos externa.
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.