NAS, Synology y Unraid

Usa HolyArrs en tu NAS con las carpetas, el propietario y el ajuste de reinicio correctos. Lee antes Instalación.

Antes de empezar

• /config va en un volumen o pool local. Nunca en una carpeta compartida de red.
• Los archivos multimedia van en una sola carpeta compartida con downloads, movies, tv y music dentro. Monta cada una, o la carpeta superior una sola vez para tener hardlinks (enlaces duros). Consulta Carpetas.

Configurar tu NAS

::tab[Synology]

1. En File Station, crea docker/holyarrs/config.
2. Crea una carpeta compartida media con downloads, movies, tv y music dentro.
3. En Container Manager, abre Project > Create (Proyecto > Crear) y pega el archivo Compose de Instalación.
4. Pon los volúmenes en /volume1/docker/holyarrs/config:/config, y luego /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music y /volume1/media/downloads:/downloads.
5. Pon PUID y PGID con los de tu usuario, a menudo 1026 y 100. Compruébalo con id <user> por SSH.
6. Da a ese usuario lectura y escritura en media: Control Panel > Shared Folder > Edit > Permissions (Panel de control > Carpeta compartida > Editar > Permisos).
7. Marca Enable auto-restart (habilitar el reinicio automático).
8. Abre http://your-server:6262. Deberías ver el asistente del primer inicio. Añade /movies, /tv y /music como carpetas de la Biblioteca.

::tab[Unraid]

Aún no hay plantilla de Community Applications, así que añade el contenedor a mano.

1. En la pestaña Docker, añade un contenedor con la imagen de HolyArrs.
2. Mapea el puerto 6262.
3. Mapea /config a una ruta de pool, como /mnt/<pool>/appdata/holyarrs. <pool> es el nombre de tu pool. No /mnt/user/appdata.
4. Mapea tus carpetas multimedia a /movies, /tv, /music y /downloads, con rutas de disco o de pool, por ejemplo /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music y /mnt/<pool>/media/downloads:/downloads.
5. Pon PUID=99, PGID=100 (el nobody:users de Unraid) y UMASK=022.
6. Activa el inicio automático del contenedor, para que se reinicie solo.
7. Abre http://your-server:6262. Deberías ver el asistente del primer inicio.

::tab[QNAP]

1. Crea Container/holyarrs/config y una carpeta compartida media con downloads, movies, tv y music dentro.
2. En Container Station, abre Applications > Create (Aplicaciones > Crear) y pega el archivo Compose.
3. Usa /share/Container/holyarrs/config:/config, y luego /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music y /share/media/downloads:/downloads.
4. Pon PUID y PGID con los del propietario de la carpeta compartida media.
5. Pon la política de reinicio en unless-stopped.
6. Abre http://your-server:6262. Deberías ver el asistente del primer inicio.

::tab[TrueNAS SCALE]

1. Crea 2 datasets: apps/holyarrs-config y media, con las carpetas downloads, movies, tv y music dentro de media.
2. En Apps, añade una app personalizada desde YAML con el archivo Compose.
3. Usa /mnt/<pool>/apps/holyarrs-config:/config, y luego /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music y /mnt/<pool>/media/downloads:/downloads.
4. Pon PUID y PGID con los del propietario del dataset, a menudo 568. Da a ese usuario permiso de escritura en la ACL del dataset.
5. Pon la política de reinicio en unless-stopped.
6. Abre http://your-server:6262. Deberías ver el asistente del primer inicio.

En cualquier NAS: da al usuario de PUID lectura y escritura en la carpeta multimedia desde la pantalla de permisos del NAS; HolyArrs se ocupa él mismo de la carpeta de configuración. Activa el reinicio automático del contenedor (la política unless-stopped de Docker).

Para tener hardlinks, que no ocupan espacio extra y terminan al instante, monta la única carpeta multimedia en lugar de las cuatro, y da a tu gestor de descargas el mismo montaje en la misma ruta. Consulta Carpetas multimedia.

Opciones

Montajes separados

Montar /movies, /tv, /music y /downloads uno por uno funciona, pero cada importación se convierte en una copia completa. Cada montaje es un sistema de archivos propio dentro del contenedor, y un hardlink no puede cruzar de un sistema de archivos a otro. Las carpetas compartidas o los datasets separados bajo una misma carpeta superior también copian. Settings > Library folders (Ajustes > Carpetas de la Biblioteca) advierte cuando HolyArrs tiene que copiar.

Deja dormir tus discos

Estas tareas despiertan los discos multimedia. Cambia cada cuánto se ejecutan en la página Schedules (Programaciones).

Tarea	Qué lee
Rescan the Library (volver a escanear la Biblioteca)	Todas las carpetas de la Biblioteca. Es la que más despierta los discos.
Check Library folders (comprobar las carpetas de la Biblioteca)	Los detalles y el espacio libre de cada carpeta. La prueba de escritura y de hardlink solo se ejecuta al iniciar, con Run now (ejecutar ahora) y cuando cambian las carpetas.
Look for missing subtitles (buscar subtítulos que faltan), Look for better subtitles (buscar subtítulos mejores)	La carpeta que está junto a cada vídeo.

• Pon /config y la carpeta de descargas en un SSD o en un pool de caché.
• Mantén 1 GB libre en el disco que contiene /config. Por debajo de eso recibes una advertencia de salud.
• En Unraid, el plugin Cache Directories mantiene en memoria los listados de carpetas, así que los escaneos no tocan el disco.
• Importar, añadir y borrar tocan el disco en el que trabajan, en el momento en que ocurren.
• Pon el escaneo cada 7 días o desactívalo. Los archivos que añades a mano solo se encuentran entonces cuando haces clic en Run now en Rescan the Library.
• Un torrent que se está compartiendo lee su archivo. Si está enlazado con un hardlink en tu Biblioteca, ese disco sigue despierto hasta que deja de compartirse.

Si no funciona

Síntoma	Causa	Solución
No se inicia y nombra una ruta FUSE, una carpeta compartida de red o un user share de Unraid	/config no está en un disco local (en Unraid, apunta a /mnt/user)	Pasa /config a un disco local o a una ruta de pool, como /mnt/<pool>/appdata/holyarrs.
Se queda detenido después de un reinicio o una restauración	El reinicio automático está desactivado	Actívalo e inicia el contenedor.
Las importaciones fallan con un error de permisos	El usuario de PUID no puede escribir en la carpeta multimedia	Dale lectura y escritura en la pantalla de permisos del NAS (en Synology: Control Panel > Shared Folder > Edit > Permissions).
Las importaciones son copias, no hardlinks	Las descargas y la Biblioteca están en montajes o discos distintos	Monta una sola carpeta compartida una vez, en HolyArrs y en el gestor de descargas.

Más soluciones: Solución de problemas.

Para expertos

Por qué HolyArrs rechaza algunas rutas de configuración

HolyArrs guarda sus bases de datos en /config. Las carpetas compartidas de red y las rutas FUSE pueden dañarlas, así que HolyArrs se niega a iniciarse en una de ellas y dice por qué.

En Unraid, /mnt/user es una ruta FUSE. Usa una ruta de pool, o haz que appdata sea Exclusive: activa Permit exclusive shares (permitir shares exclusivos) en Settings > Global Share Settings (Ajustes > Ajustes globales de shares), y luego pon Shares > appdata con el almacenamiento principal en un pool y el almacenamiento secundario en ninguno.

Una ruta de /config en un pool que no existe acaba en memoria y se pierde al reiniciar. HolyArrs también rechaza eso. Evita /mnt/user también para los archivos multimedia; los hardlinks a través de él pueden fallar.

Por qué importa el reinicio automático

Reiniciar desde la app, el Modo seguro y la restauración de una copia de seguridad detienen HolyArrs y esperan que Docker lo inicie otra vez. Sin reinicio automático se queda detenido. Consulta Partes y Modo seguro.

Puerto y actualizaciones

• Mapea el puerto 6262 solo a tu red de casa. Lee Conceptos básicos de seguridad antes de abrirlo a alguien de fuera.
• Para actualizar, descarga la imagen nueva y vuelve a crear el contenedor. Tus datos se quedan en /config. Consulta Actualizaciones.

Relacionado

• Carpetas
• Carpetas de la Biblioteca
• Programaciones