Ragnarr maakt of relayt geen inloggegevens. Kopieer voor elke dienst de API-sleutel (of inloggegevens) uit het instellingenscherm van de dienst zelf, plak die in Ragnarr en gebruik Verbinding testen voordat je opslaat. De basis-URL is altijd het adres dat je in een browser zou typen om de dienst te bereiken, bijvoorbeeld https://sonarr.example.com of http://192.168.1.50:8989.

Sonarr, Radarr, Lidarr, Prowlarr

Open de webinterface van de dienst, ga naar Settings → General en kopieer de waarde van het veld API Key (onder de sectie Security). De sleutel is een reeks van 32 tekens. Als je hem daar opnieuw genereert, stopt elke client die de oude sleutel gebruikt - inclusief Ragnarr - met werken totdat je hem bijwerkt.

Als de dienst is geconfigureerd met een URL Base (bijvoorbeeld /sonarr voor reverse proxying op basis van pad), neem die dan op in de basis-URL die je aan Ragnarr geeft: https://media.example.com/sonarr.

Bazarr

Ga in de webinterface van Bazarr naar Settings → General en kopieer de API Key onder de sectie Security.

qBt

qBt gebruikt de gebruikersnaam en het wachtwoord van de Web UI in plaats van een API-sleutel. Controleer in de desktop- of webclient Extra → Opties → Web UI: de Web UI moet ingeschakeld en bereikbaar zijn vanaf je iPhone of iPad, en de inloggegevens die je daar instelt zijn degene die je in Ragnarr invoert. Als je "Authenticatie omzeilen voor clients op localhost" hebt ingeschakeld, onthoud dan dat dit alleen voor localhost geldt - externe clients zoals Ragnarr moeten zich alsnog authenticeren.

SABnzbd

Ga naar Config → General en kopieer de API Key (de volledige API-sleutel, niet de beperkte "NZB key", die alleen downloads kan toevoegen).

Jellyfin, Emby

Open in Jellyfin het Beheerdashboard → API-sleutels en maak een sleutel aan voor Ragnarr. Emby werkt op dezelfde manier vanuit het serverbeheerscherm. Een aparte sleutel per client maakt het makkelijk om later één apparaat in te trekken zonder de andere te raken.

Seerr

Werkt met Overseerr en Jellyseerr. Kopieer de API Key uit Settings → General in de webinterface van Seerr.

Tautulli

Ga naar Settings → Web Interface en kopieer de API key onderaan de pagina (schakel de API in als die uitstaat).

Portainer

Maak een access-token aan via My account → Access tokens. Tokens worden maar één keer getoond bij het aanmaken - kopieer het direct in Ragnarr en test de verbinding voordat je de pagina sluit.

Unraid

Ragnarr communiceert met Unraid via de officiële Unraid GraphQL-API met een API-sleutel. Maak een sleutel aan in de API-instellingen van je server en plak die in Ragnarr.

Freebox

Geen API-sleutel nodig: Ragnarr koppelt rechtstreeks met de Freebox. Voeg de dienst toe en keur het autorisatieverzoek goed op het display van de Freebox wanneer daarom wordt gevraagd.

Veelvoorkomende fouten

  • 401 Unauthorized - de sleutel is verkeerd, is opnieuw gegenereerd of hoort bij een andere instantie. Kopieer hem opnieuw uit de instellingen van de dienst.
  • 404 Not Found - in de basis-URL ontbreekt het URL Base-pad van de dienst, of hij wijst naar de verkeerde poort.
  • Timeout - de URL is niet bereikbaar vanaf het huidige netwerk van je apparaat. Test hem eerst in Mobile Safari; als het daar mislukt, mislukt het ook in Ragnarr. Zie de Tailscale/VPN-gids voor toegang op afstand.

Beveiligingsnotities

  • Mail geen API-sleutels naar support.
  • Vervang een sleutel als je vermoedt dat hij per ongeluk is gedeeld.
  • Geef de voorkeur aan HTTPS, een VPN of een vertrouwd lokaal netwerk voor toegang op afstand.

Gerelateerde gidsen

Terug naar alle gidsen, of bekijk de support-FAQ voor het oplossen van verbindingsproblemen.