Ragnarr ne crée ni ne relaie aucun identifiant. Pour chaque service, copiez la clé API (ou les identifiants) depuis l'écran de réglages du service lui-même, collez-la dans Ragnarr, puis utilisez Tester la connexion avant d'enregistrer. L'URL de base est toujours l'adresse que vous taperiez dans un navigateur pour joindre le service, par exemple https://sonarr.example.com ou http://192.168.1.50:8989.

Sonarr, Radarr, Lidarr, Prowlarr

Ouvrez l'interface web du service, allez dans Settings → General et copiez la valeur du champ API Key (section Security). La clé fait 32 caractères. Si vous la régénérez, tous les clients utilisant l'ancienne clé - Ragnarr compris - cessent de fonctionner jusqu'à mise à jour.

Si le service est configuré avec une URL Base (par exemple /sonarr pour un reverse proxy par chemin), incluez-la dans l'URL de base donnée à Ragnarr : https://media.example.com/sonarr.

Bazarr

Dans l'interface web de Bazarr, allez dans Settings → General et copiez l'API Key dans la section Security.

qBt

qBt utilise l'identifiant et le mot de passe de la Web UI au lieu d'une clé API. Dans le client desktop ou web, vérifiez Outils → Options → Interface Web : la Web UI doit être activée et joignable depuis votre iPhone ou iPad, et ce sont ces identifiants qu'il faut saisir dans Ragnarr. Si vous avez activé « Passer l'authentification pour les clients sur localhost », rappelez-vous que cela ne vaut que pour localhost - les clients distants comme Ragnarr s'authentifient quand même.

SABnzbd

Allez dans Config → General et copiez l'API Key (la clé API complète, pas la « NZB key » limitée qui ne peut qu'ajouter des téléchargements).

Jellyfin, Emby

Dans Jellyfin, ouvrez le Tableau de bord admin → Clés API et créez une clé pour Ragnarr. Emby fonctionne pareil depuis l'écran de gestion du serveur. Une clé dédiée par client permet de révoquer un appareil plus tard sans toucher aux autres.

Seerr

Fonctionne avec Overseerr et Jellyseerr. Copiez l'API Key depuis Settings → General dans l'interface web de Seerr.

Tautulli

Allez dans Settings → Web Interface et copiez l'API key en bas de page (activez l'API si elle est désactivée).

Portainer

Créez un jeton d'accès depuis My account → Access tokens. Les jetons ne s'affichent qu'à la création - copiez-le directement dans Ragnarr et testez la connexion avant de fermer la page.

Unraid

Ragnarr dialogue avec Unraid via l'API GraphQL officielle d'Unraid, avec une clé API. Créez une clé depuis les réglages API de votre serveur et collez-la dans Ragnarr.

Freebox

Aucune clé API nécessaire : Ragnarr s'appaire directement avec la Freebox. Ajoutez le service, puis approuvez la demande d'autorisation sur l'écran de la Freebox quand elle s'affiche.

Erreurs courantes

  • 401 Unauthorized - la clé est erronée, a été régénérée ou appartient à une autre instance. Recopiez-la depuis les réglages du service.
  • 404 Not Found - l'URL de base omet le chemin URL Base du service, ou pointe vers le mauvais port.
  • Timeout - l'URL n'est pas joignable depuis le réseau actuel de votre appareil. Testez-la d'abord dans Safari mobile ; si elle échoue là, elle échouera dans Ragnarr. Voir le guide Tailscale/VPN pour l'accès distant.

Notes de sécurité

  • N'envoyez jamais de clés API par e-mail au support.
  • Régénérez une clé si vous pensez l'avoir partagée par accident.
  • Privilégiez HTTPS, un VPN ou un réseau local de confiance pour l'accès distant.

Guides liés

Retour à tous les guides, ou consultez la FAQ support pour le dépannage des connexions.