NAS, Synology e Unraid

Use o HolyArrs no seu NAS com as pastas, o proprietário e a configuração de reinício certos. Leia Instalação antes.

Antes de começar

• /config fica em um volume ou pool local. Nunca em um compartilhamento de rede.
• A mídia fica em uma única pasta compartilhada com downloads, movies, tv e music dentro. Monte cada uma, ou a pasta de cima uma vez só para ter hardlinks (links físicos). Veja Pastas.

Configurar seu NAS

::tab[Synology]

1. No File Station, crie docker/holyarrs/config.
2. Crie uma pasta compartilhada media com downloads, movies, tv e music dentro.
3. No Container Manager, abra Project > Create (projeto > criar) e cole o arquivo Compose de Instalação.
4. Defina 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. Defina PUID e PGID com os do seu usuário, muitas vezes 1026 e 100. Confira com id <user> por SSH.
6. Dê a esse usuário leitura e escrita em media: Control Panel > Shared Folder > Edit > Permissions (painel de controle > pasta compartilhada > editar > permissões).
7. Marque Enable auto-restart (ativar reinício automático).
8. Abra http://your-server:6262. Você deve ver o assistente da primeira execução. Adicione /movies, /tv e /music como pastas da Biblioteca.

::tab[Unraid]

Ainda não existe um modelo no Community Applications, então adicione o container à mão.

1. Na aba Docker, adicione um container com a imagem do HolyArrs.
2. Mapeie a porta 6262.
3. Mapeie /config para um caminho de pool, como /mnt/<pool>/appdata/holyarrs. <pool> é o nome do seu pool. Não use /mnt/user/appdata.
4. Mapeie suas pastas de mí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. Defina PUID=99, PGID=100 (o nobody:users do Unraid) e UMASK=022.
6. Ative o início automático do container, para ele reiniciar sozinho.
7. Abra http://your-server:6262. Você deve ver o assistente da primeira execução.

::tab[QNAP]

1. Crie Container/holyarrs/config e um compartilhamento media com downloads, movies, tv e music dentro.
2. No Container Station, abra Applications > Create (aplicativos > criar) e cole o arquivo Compose.
3. Use /share/Container/holyarrs/config:/config, depois /share/media/movies:/movies, /share/media/tv:/tv, /share/media/music:/music e /share/media/downloads:/downloads.
4. Defina PUID e PGID com os do proprietário do compartilhamento media.
5. Defina a política de reinício como unless-stopped.
6. Abra http://your-server:6262. Você deve ver o assistente da primeira execução.

::tab[TrueNAS SCALE]

1. Crie 2 datasets: apps/holyarrs-config e media, com as pastas downloads, movies, tv e music dentro de media.
2. Em Apps, adicione um app personalizado a partir de YAML com o arquivo Compose.
3. Use /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. Defina PUID e PGID com os do proprietário do dataset, muitas vezes 568. Dê a esse usuário permissão de escrita na ACL do dataset.
5. Defina a política de reinício como unless-stopped.
6. Abra http://your-server:6262. Você deve ver o assistente da primeira execução.

Em todo NAS: dê ao usuário do PUID leitura e escrita na pasta de mídia, na tela de permissões do NAS; da pasta de configuração o próprio HolyArrs cuida. Ative o reinício automático do container (a política unless-stopped do Docker).

Para ter hardlinks, que não ocupam espaço extra e terminam na hora, monte a pasta de mídia única no lugar das quatro e dê ao seu gerenciador de downloads a mesma montagem no mesmo caminho. Veja Pastas de mídia.

Opções

Montagens separadas

Montar /movies, /tv, /music e /downloads uma por uma funciona, mas toda importação vira uma cópia completa. Cada montagem é um sistema de arquivos próprio dentro do container, e um hardlink não atravessa sistemas de arquivos. Compartilhamentos ou datasets separados debaixo de uma mesma pasta também copiam. Settings > Library folders (configurações > pastas da Biblioteca) avisa quando o HolyArrs precisa copiar.

Deixar seus discos dormirem

Estas tarefas acordam os discos de mídia. Mude a frequência delas na página Schedules (agendamentos).

Tarefa	O que ela lê
Rescan the Library (reler 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 roda só na inicialização, em Run now (executar agora) e quando as pastas mudam.
Look for missing subtitles (buscar legendas que faltam), Look for better subtitles (buscar legendas melhores)	A pasta ao lado de cada vídeo.

• Coloque /config e a pasta de downloads em um SSD ou em um pool de cache.
• Mantenha 1 GB livre no disco onde fica /config. Abaixo disso você recebe um aviso de saúde.
• No Unraid, o plugin Cache Directories mantém as listas de pastas na memória, então as leituras não tocam no disco.
• Importar, adicionar e excluir mexem no disco em que trabalham, na hora em que acontecem.
• Defina a releitura para cada 7 dias ou desative. Os arquivos que você adiciona à mão só são encontrados quando você clica em Run now em Rescan the Library.
• Um torrent que está semeando lê o arquivo dele. Se o arquivo está na sua Biblioteca por hardlink, esse disco fica acordado até o torrent parar de semear.

Se não funcionar

Sintoma	Causa	Solução
Não inicia e cita um caminho FUSE, um compartilhamento de rede ou um user share do Unraid	/config não está em disco local (no Unraid, aponta para /mnt/user)	Mova /config para um disco local ou um caminho de pool, como /mnt/<pool>/appdata/holyarrs.
Fica parado depois de reiniciar ou restaurar	O reinício automático está desativado	Ative e inicie o container.
As importações falham com erro de permissão	O usuário do PUID não consegue escrever na mídia	Dê leitura e escrita a ele na tela de permissões do NAS (no Synology: Control Panel > Shared Folder > Edit > Permissions).
As importações são cópias, não hardlinks	Os downloads e a Biblioteca estão em montagens ou discos diferentes	Monte uma única pasta compartilhada, uma vez só, no HolyArrs e no gerenciador de downloads.

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

Para especialistas

Por que o HolyArrs recusa alguns caminhos de configuração

O HolyArrs guarda os bancos de dados em /config. Compartilhamentos de rede e caminhos FUSE podem corromper esses bancos, então o HolyArrs se recusa a iniciar em um deles e diz por quê.

No Unraid, /mnt/user é um caminho FUSE. Use um caminho de pool, ou deixe o appdata como Exclusive: ative Permit exclusive shares (permitir compartilhamentos exclusivos) em Settings > Global Share Settings (configurações > configurações globais de compartilhamento), depois defina Shares > appdata (compartilhamentos > appdata) com armazenamento primário em um pool e armazenamento secundário como nenhum.

Um caminho de /config em um pool que não existe vai parar na memória e se perde ao reiniciar o servidor. O HolyArrs recusa isso também. Evite /mnt/user para a mídia também; hardlinks através dele podem falhar.

Por que o reinício automático importa

O reinício pelo app, o modo de segurança e a restauração de um backup param o HolyArrs e esperam que o Docker inicie de novo. Sem o reinício automático, ele fica parado. Veja Partes e modo de segurança.

Porta e atualizações

• Mapeie a porta 6262 só para sua rede de casa. Leia Noções de segurança antes de abrir a porta para alguém de fora.
• Para atualizar, baixe a imagem nova e recrie o container. Seus dados ficam em /config. Veja Atualizações.

Relacionados

• Pastas
• Pastas da Biblioteca
• Agendamentos