O Ragnarr não cria nem faz proxy de credenciais. Para cada serviço, copie a chave de API (ou as credenciais) do ecrã de definições do próprio serviço, cole-a no Ragnarr e use Testar conexão antes de guardar. A URL base é sempre o endereço que escreveria num navegador para chegar ao serviço, por exemplo https://sonarr.example.com ou http://192.168.1.50:8989.

Sonarr, Radarr, Lidarr, Prowlarr

Abra a interface web do serviço, vá a Settings → General e copie o valor do campo API Key (na secção Security). A chave tem 32 caracteres. Se a regenerar, todos os clientes que usam a chave antiga - incluindo o Ragnarr - deixam de funcionar até serem atualizados.

Se o serviço estiver configurado com uma URL Base (por exemplo /sonarr para reverse proxy por caminho), inclua-a na URL base que indica ao Ragnarr: https://media.example.com/sonarr.

Bazarr

Na interface web do Bazarr, vá a Settings → General e copie a API Key na secção Security.

qBt

O qBt usa o nome de utilizador e a palavra-passe da Web UI em vez de uma chave de API. No cliente desktop ou web, verifique Ferramentas → Opções → Interface Web: a Web UI tem de estar ativada e acessível a partir do seu iPhone ou iPad, e são essas credenciais que deve introduzir no Ragnarr. Se ativou «Ignorar autenticação para clientes em localhost», lembre-se de que isso só vale para localhost - os clientes remotos como o Ragnarr continuam a autenticar-se.

SABnzbd

Vá a Config → General e copie a API Key (a chave de API completa, não a «NZB key» limitada, que só pode adicionar transferências).

Jellyfin, Emby

No Jellyfin, abra o Painel de administração → Chaves de API e crie uma chave para o Ragnarr. O Emby funciona da mesma forma a partir do ecrã de gestão do servidor. Uma chave dedicada por cliente permite revogar um dispositivo mais tarde sem mexer nos outros.

Seerr

Funciona com Overseerr e Jellyseerr. Copie a API Key em Settings → General na interface web do Seerr.

Tautulli

Vá a Settings → Web Interface e copie a API key no fundo da página (ative a API se estiver desativada).

Portainer

Crie um token de acesso em My account → Access tokens. Os tokens só são apresentados no momento da criação - copie-o diretamente para o Ragnarr e teste a ligação antes de fechar a página.

Unraid

O Ragnarr comunica com o Unraid através da API GraphQL oficial do Unraid, com uma chave de API. Crie uma chave nas definições de API do seu servidor e cole-a no Ragnarr.

Freebox

Não é necessária chave de API: o Ragnarr emparelha diretamente com a Freebox. Adicione o serviço e aprove o pedido de autorização no ecrã da Freebox quando este surgir.

Erros comuns

  • 401 Unauthorized - a chave está errada, foi regenerada ou pertence a outra instância. Volte a copiá-la das definições do serviço.
  • 404 Not Found - a URL base não inclui o caminho URL Base do serviço, ou aponta para a porta errada.
  • Timeout - a URL não está acessível a partir da rede atual do seu dispositivo. Teste-a primeiro no Safari móvel; se falhar aí, falhará no Ragnarr. Consulte o guia Tailscale/VPN para acesso remoto.

Notas de segurança

  • Nunca envie chaves de API por e-mail para o suporte.
  • Regenere uma chave se achar que a partilhou por engano.
  • Prefira HTTPS, uma VPN ou uma rede local de confiança para acesso remoto.

Guias relacionados

Voltar a todos os guias, ou consulte as FAQ de suporte para resolver problemas de ligação.