Guía de HolyArrs con Docker: sustituye Sonarr, Radarr, Lidarr, Bazarr, Prowlarr y Overseerr con una sola app de 15 MB

Una instalación habitual de automatización multimedia suele montar seis aplicaciones distintas: Sonarr para series, Radarr para películas, Lidarr para música, Prowlarr para indexadores, Bazarr para subtítulos y Overseerr para que tu familia pueda pedir contenido. Son seis contenedores, seis inicios de sesión, seis ciclos de actualización y seis claves API que tienes que ir copiando entre sí para que se entiendan.

HolyArrs reescribe todo ese conjunto en Go dentro de un único contenedor autoalojado. La imagen descarga unos 15 MB, marca alrededor de 140 MiB de RAM en las pruebas del proyecto con una biblioteca de 10.000 títulos y superó las 1.000 estrellas en GitHub poco después de presentarse en Show HN. Como su importador integrado solo lee tus aplicaciones actuales sin modificarlas, puedes levantarlo en paralelo a tu stack *arr y comparar resultados sin romper nada. Esta guía repasa la instalación con Docker Compose, la conexión con qBittorrent y Jellyfin, la migración no destructiva y los compromisos de un proyecto joven antes de apagar tus contenedores antiguos.

Qué sustituye HolyArrs en cifras

Según la comparativa del propio proyecto en amd64 frente a las imágenes estándar de linuxserver.io:

En disco supone unas 48 veces menos espacio. Donde más se nota en un VPS pequeño o en una Raspberry Pi es en memoria: seis servicios .NET en reposo frente a un único binario en Go que ronda los ~140 MiB de RAM con 10.000 títulos y 55.000 películas y episodios indexados en las cifras publicadas por el proyecto.

Lo que no cambia es su papel alrededor: HolyArrs no descarga archivos por su cuenta. Controla el cliente que ya tengas (qBittorrent, Transmission, Deluge, rTorrent, aria2, SABnzbd o NZBGet), consulta indexadores Torznab/Newznab o sincroniza con Prowlarr/Jackett y avisa a Plex, Jellyfin o Emby cuando llega material nuevo. Las seis piezas de gestión quedan unificadas; el cliente de descargas y el servidor multimedia siguen en su sitio.

Qué necesitas antes de empezar

Antes de crear el compose, revisa la estructura de carpetas. La plantilla oficial de HolyArrs mapea /movies, /tv, /music y /downloads por separado, pero montar una sola carpeta padre /media con las cuatro subcarpetas dentro (y usar exactamente ese mismo montaje en el cliente de descargas) permite mover archivos terminados al instante de forma atómica sin copiar gigabytes dos veces. Ambas opciones funcionan desde la interfaz; la carpeta padre única ahorra mucha escritura en disco.

Instalar HolyArrs con Docker Compose

mkdir -p /opt/holyarrs/config
cd /opt/holyarrs

Archivo Compose fijado en la versión 1.1.0, que incorporó 44 idiomas y soporte para aria2:

name: holyarrs
services:
  holyarrs:
    image: holyarrs/holyarrs:1.1.0
    container_name: holyarrs
    environment:
      - PUID=1000        # match `id youruser`
      - PGID=1000
      - TZ=Europe/Bucharest
    volumes:
      - /opt/holyarrs/config:/config          # local disk only
      - /mnt/media:/media                     # one parent: /media/{movies,tv,music,downloads}
    ports:
      - 6262:6262
    restart: unless-stopped

docker compose up -d
docker logs -f holyarrs

Con un directorio padre /media que agrupa movies, tv, music y downloads, y qBittorrent montando /mnt/media/downloads en /media/downloads dentro de su contenedor, HolyArrs traslada descargas completas sin duplicar lecturas ni escrituras. Si el cliente de descargas corre en otro equipo, monta el mismo recurso NFS/SMB con idéntica ruta en ambos servidores (manteniendo /config siempre en disco local).

Primer arranque: propietario, carpetas y descargas

Abre http://tu-servidor:6262 y crea la cuenta propietaria de inmediato. No existe contraseña por defecto y la primera persona en entrar al panel pasa a ser propietaria; en una red compartida conviene hacerlo nada más arrancar el contenedor.

El asistente inicial pide tres datos básicos:

1. Carpetas de biblioteca. Indica las rutas vistas dentro del contenedor (/media/movies, /media/tv), no las rutas reales del host.
2. Cliente de descargas. Elige qBittorrent e introduce su URL y usuario. Si ambos corren en Docker, localhost apunta al propio contenedor de HolyArrs, así que usa el nombre del servicio qBittorrent dentro de una red Docker compartida o la IP del host.
3. Una Fuente (Source). Añade cualquier indexador Torznab/Newznab o enlaza tu Prowlarr existente. HolyArrs acepta los indexadores empujados desde la sincronización de Prowlarr, así que puedes pasar toda tu lista de una vez.

Al terminar entrarás en Explore, con un diseño cercano a una plataforma de streaming: al pasar el cursor por un título reproduce su tráiler, puedes solicitar una serie completa o una temporada concreta y tus reglas Pick (tamaño, calidad e idioma) deciden qué versión descargar.

Importar tu stack *arr actual (sin romper nada)

Aquí está la gran ventaja para probarlo sin riesgo. Ve a Settings > Move from other apps, introduce la URL y la clave API de cada aplicación antigua (o sube un zip de copia de seguridad), pulsa Try it para hacer un simulacro y confirma con Move. El importador se limita a leer tus servicios actuales, así que Sonarr, Radarr y compañía siguen funcionando intactos y puedes dar marcha atrás cuando quieras.

No se trasladan formatos personalizados (custom formats), etiquetas, historial de capturas ni contraseñas guardadas; deberás volver a introducir secretos o importarlos aparte. Los archivos multimedia en disco ni se mueven ni se borran.

La estrategia más segura consiste en importar todo, mantener activos tus contenedores actuales y observar una semana de estrenos desde el calendario de HolyArrs. Si algún lanzamiento falla, puedes contrastar el motivo directamente frente al stack que ya conoces.

Conectar con Jellyfin (o Plex/Emby)

En Settings > Media servers, añade la URL de Jellyfin y una clave API (Jellyfin Dashboard > API Keys > New). HolyArrs envía un aviso específico nada más importar un archivo para que el nuevo episodio aparezca enseguida sin esperar al escaneo programado. Si Jellyfin corre en Docker en la misma máquina, usa su nombre de contenedor dentro de una red Docker compartida o la IP del puente Docker en vez de localhost.

¿Aún no tienes servidor multimedia? Nuestra guía para autoalojar Jellyfin detalla el montaje completo con Docker y transcodificación por hardware, y en mejor NAS para Plex y Jellyfin comparamos equipos de almacenamiento si partes desde cero.

Mantenimiento: copias, actualizaciones y doctor

Tres detalles importantes tras dejarlo en marcha:

La clave maestra (holyarrs.key). Las contraseñas y claves API guardadas se cifran con holyarrs.key dentro de /config, y las copias de seguridad normales la excluyen a propósito. Entra en Settings > Backups > Download key kit y guarda una copia fuera del servidor. Si pierdes holyarrs.key, las credenciales respaldadas no podrán descifrarse.

Actualizaciones con el flujo habitual de Compose:

docker compose pull && docker compose up -d

Si una versión cambia el esquema interno, HolyArrs guarda automáticamente una copia previa. Para revertirla ejecuta docker exec holyarrs /holyarrs restore --pre-update y reinicia el contenedor.

Diagnóstico sin shell. La imagen prescinde de shell interno, algo bueno para reducir superficie de ataque pero incómodo si esperas entrar con docker exec -it holyarrs bash. En su lugar trae comandos integrados:

docker exec holyarrs /holyarrs doctor        # OK/WARN/FAIL config check with fixes
docker exec -i holyarrs /holyarrs reset-owner  # locked out of owner account
docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Qué le falta todavía

El README del proyecto deja claras sus limitaciones actuales, y conviene tenerlas presentes antes de sustituir todo:

• Sin cliente de descargas integrado: depende de qBittorrent, SABnzbd o alguno de los demás clientes compatibles, aunque uno integrado figura en la hoja de ruta.
• Sin funciones de IA ni MCP en la rama 1.x.
• Solo interfaz web: todavía no hay apps nativas para móvil o televisor, aunque la web se adapta bien al navegador del teléfono.
• Sección de música incompleta: el descubrimiento musical dentro de Explore sigue en desarrollo.
• Servidor centralizado de metadatos: las carátulas, tráilers y listas llegan desde un servicio operado y costeado por el autor. Te ahorra configurar claves personales de TMDb o TVDb, pero introduce una dependencia externa. Tus descargas y bibliotecas existentes siguen funcionando si ese servidor cae, aunque la exploración visual depende de él.

Esa dependencia centralizada de metadatos es la mayor diferencia estructural frente a Sonarr y Radarr, que consultan directamente TMDb y TVDb. Hoy HolyArrs está mantenido principalmente por un único desarrollador (CoderLuii, bajo licencia AGPL-3.0 con CLA), así que conservar tu stack previo respaldado sigue siendo lo más sensato.

Preguntas frecuentes

Conclusión

Merece una prueba rápida si estás cansado de mantener seis inicios de sesión, seis archivos de configuración y más de 700 MB de imágenes solo para automatizar descargas. HolyArrs cubre el ciclo principal (buscar, solicitar, enviar al cliente, importar y avisar a Plex o Jellyfin) dentro de un único contenedor muy ligero.

Mantén el stack anterior junto a él durante un tiempo. Cualquier reescritura 1.x frente a seis aplicaciones .NET veteranas tendrá roces puntuales con indexadores concretos, reglas de nombrado exigentes o clientes específicos. Como el importador tarda 15 minutos y no toca nada existente, evaluarlo en paralelo apenas conlleva riesgo.

Artículos relacionados

• Autoalojar Jellyfin con Docker Compose (el servidor multimedia al que avisa HolyArrs)
• Mejor NAS para Plex y Jellyfin (cajas de almacenamiento para tu biblioteca)
• Mejores contenedores Docker para un servidor en casa (qué más ejecutar en el mismo host)
• Traefik como proxy inverso para Docker (para exponer HolyArrs con HTTPS)
• Secretos en Docker Compose (sacar claves API fuera de archivos Compose en texto plano)