NAS, Synology e Unraid

Executa o HolyArrs no teu NAS com as pastas, o dono e a definição de reinício certos. Lê primeiro Instalar.

Antes de começares

• /config vai num volume ou pool local. Nunca numa partilha de rede.
• Os ficheiros multimédia vão numa única pasta partilhada com downloads, movies, tv e music lá dentro. Monta cada uma, ou a pasta de cima uma só vez para teres hardlinks (ligação direta). Vê Pastas.

Configurar o teu NAS

::tab[Synology]

1. No File Station, cria docker/holyarrs/config.
2. Cria uma pasta partilhada media com downloads, movies, tv e music lá dentro.
3. No Container Manager, abre Project > Create (projeto > criar) e cola o ficheiro Compose de Instalar.
4. Define os volumes como /volume1/docker/holyarrs/config:/config, depois /volume1/media/movies:/movies, /volume1/media/tv:/tv, /volume1/media/music:/music e /volume1/media/downloads:/downloads.
5. Define PUID e PGID para o teu utilizador, muitas vezes 1026 e 100. Confirma com id <user> por SSH.
6. Dá a esse utilizador permissão de leitura e escrita em media: Control Panel > Shared Folder > Edit > Permissions (painel de controlo > pasta partilhada > editar > permissões).
7. Assinala Enable auto-restart (ativar reinício automático).
8. Abre http://your-server:6262. Deves ver o assistente da primeira execução. Adiciona /movies, /tv e /music como pastas da Biblioteca.

::tab[Unraid]

Ainda não há um modelo nas Community Applications, por isso adiciona o contentor à mão.

1. No separador Docker, adiciona um contentor com a imagem do HolyArrs.
2. Mapeia a porta 6262.
3. Mapeia /config para um caminho de um pool, como /mnt/<pool>/appdata/holyarrs. <pool> é o nome do teu pool. Não /mnt/user/appdata.
4. Mapeia as tuas pastas de multimédia para /movies, /tv, /music e /downloads, usando caminhos de disco ou de pool, por exemplo /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music e /mnt/<pool>/media/downloads:/downloads.
5. Define PUID=99, PGID=100 (o nobody:users do Unraid) e UMASK=022.
6. Ativa o arranque automático do contentor, para ele reiniciar sozinho.
7. Abre http://your-server:6262. Deves ver o assistente da primeira execução.

::tab[QNAP]

1. Cria Container/holyarrs/config e uma partilha media com downloads, movies, tv e music lá dentro.
2. No Container Station, abre Applications > Create (aplicações > criar) e cola o ficheiro Compose.
3. Usa /share/Container/holyarrs/config:/config, depois /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music e /share/media/downloads:/downloads.
4. Define PUID e PGID para o dono da partilha media.
5. Define a política de reinício como unless-stopped.
6. Abre http://your-server:6262. Deves ver o assistente da primeira execução.

::tab[TrueNAS SCALE]

1. Cria 2 datasets: apps/holyarrs-config e media, com as pastas downloads, movies, tv e music dentro de media.
2. Em Apps, adiciona uma app personalizada a partir de YAML com o ficheiro Compose.
3. Usa /mnt/<pool>/apps/holyarrs-config:/config, depois /mnt/<pool>/media/movies:/movies, /mnt/<pool>/media/tv:/tv, /mnt/<pool>/media/music:/music e /mnt/<pool>/media/downloads:/downloads.
4. Define PUID e PGID para o dono do dataset, muitas vezes 568. Dá a esse utilizador acesso de escrita na ACL do dataset.
5. Define a política de reinício como unless-stopped.
6. Abre http://your-server:6262. Deves ver o assistente da primeira execução.

Em qualquer NAS: dá ao utilizador do PUID permissão de leitura e escrita na pasta de multimédia no ecrã de permissões do NAS; o HolyArrs trata ele próprio da pasta de configuração. Ativa o reinício automático do contentor (a política unless-stopped do Docker).

Para teres hardlinks, que não ocupam espaço extra e ficam prontos de imediato, monta a pasta de multimédia única no lugar das quatro e dá ao teu gestor de transferências a mesma montagem no mesmo caminho. Vê Pastas de multimédia.

Opções

Montagens separadas

Montar /movies, /tv, /music e /downloads uma a uma funciona, mas cada importação passa a ser uma cópia completa. Cada montagem é o seu próprio sistema de ficheiros dentro do contentor, e um hardlink não atravessa sistemas de ficheiros. Partilhas ou datasets separados sob uma mesma pasta de cima também copiam. Settings > Library folders (Definições > Pastas da Biblioteca) avisa quando o HolyArrs tem de copiar.

Deixar os discos dormir

Estas tarefas acordam os discos de multimédia. Muda a frequência com que correm na página Schedules (Agendamentos).

Tarefa	O que lê
Rescan the Library (voltar a analisar a Biblioteca)	Todas as pastas da Biblioteca. É a que mais acorda os discos.
Check Library folders (verificar as pastas da Biblioteca)	Os detalhes e o espaço livre de cada pasta. O teste de escrita e de hardlink só corre ao arrancar, em Run now (executar agora) e quando as pastas mudam.
Look for missing subtitles, Look for better subtitles (procurar legendas em falta, procurar legendas melhores)	A pasta ao lado de cada vídeo.

• Põe /config e a pasta de transferências num SSD ou num pool de cache.
• Mantém 1 GB livre no disco que tem /config. Abaixo disso recebes um alerta de saúde.
• No Unraid, o plugin Cache Directories guarda as listagens das pastas em memória, por isso as análises não tocam no disco.
• As importações, as adições e as eliminações tocam no disco em que trabalham, quando acontecem.
• Define a nova análise de 7 em 7 dias ou desativada. Os ficheiros que adicionares à mão só são encontrados quando clicares em Run now em Rescan the Library.
• Um torrent em seed lê o seu ficheiro. Se estiver ligado por hardlink à tua Biblioteca, esse disco fica acordado até o seed parar.

Se não funcionar

Sintoma	Causa	Solução
Não arranca, indica um caminho FUSE, uma partilha de rede ou uma partilha de utilizador do Unraid	/config não está num disco local (no Unraid, aponta para /mnt/user)	Muda /config para um disco local ou um caminho de pool, como /mnt/<pool>/appdata/holyarrs.
Fica parado depois de um reinício ou de um restauro	O reinício automático está desativado	Ativa-o e inicia o contentor.
As importações falham com um erro de permissão	O utilizador do PUID não consegue escrever na pasta de multimédia	Dá-lhe leitura e escrita no ecrã de permissões do NAS (no Synology: Control Panel > Shared Folder > Edit > Permissions).
As importações são cópias, não hardlinks	As transferências e a Biblioteca estão em montagens ou discos diferentes	Monta uma pasta partilhada uma só vez, no HolyArrs e no gestor de transferências.

Mais soluções: Resolução de problemas.

Para especialistas

Porque é que o HolyArrs recusa alguns caminhos de configuração

O HolyArrs guarda as suas bases de dados em /config. As partilhas de rede e os caminhos FUSE podem corrompê-las, por isso o HolyArrs recusa arrancar num deles e diz porquê.

No Unraid, /mnt/user é um caminho FUSE. Usa um caminho de pool, ou torna o appdata Exclusive: ativa Permit exclusive shares em Settings > Global Share Settings e depois define Shares > appdata com armazenamento primário num só pool e armazenamento secundário a nenhum.

Um caminho /config num pool que não existe vai parar à memória e perde-se ao reiniciar. O HolyArrs também recusa isso. Evita /mnt/user também para os ficheiros multimédia; os hardlinks que o atravessam podem falhar.

Porque é que o reinício automático importa

Reiniciar na app, o modo de segurança e o restauro de uma cópia de segurança param o HolyArrs e esperam que o Docker o inicie outra vez. Sem reinício automático, ele fica parado. Vê Partes e modo de segurança.

Porta e atualizações

• Mapeia a porta 6262 só para a tua rede de casa. Lê Noções básicas de segurança antes de a abrires a alguém de fora.
• Para atualizar, puxa a imagem nova e recria o contentor. Os teus dados ficam em /config. Vê Atualizações.

Relacionado

• Pastas
• Pastas da Biblioteca
• Agendamentos