API-Schlüssel für Ragnarr-Dienste finden

Ragnarr erstellt oder vermittelt keine Zugangsdaten. Kopiere für jeden Dienst den API-Schlüssel (oder die Anmeldedaten) aus dem Einstellungsbildschirm des jeweiligen Dienstes, füge ihn in Ragnarr ein und nutze dann Verbindung testen vor dem Speichern. Die Basis-URL ist immer die Adresse, die du in einem Browser eingeben würdest, um den Dienst zu erreichen, zum Beispiel https://sonarr.example.com oder http://192.168.1.50:8989.

Sonarr, Radarr, Lidarr, Prowlarr

Öffne die Weboberfläche des Dienstes, gehe zu Settings → General und kopiere den Wert des Felds API Key (im Abschnitt Security). Der Schlüssel ist eine 32 Zeichen lange Zeichenkette. Regenerierst du ihn dort, funktioniert jeder Client, der den alten Schlüssel nutzt - Ragnarr eingeschlossen - nicht mehr, bis du ihn aktualisierst.

Ist der Dienst mit einer URL Base konfiguriert (zum Beispiel /sonarr für pfadbasiertes Reverse-Proxying), nimm sie in die Basis-URL auf, die du Ragnarr gibst: https://media.example.com/sonarr.

Bazarr

Gehe in der Bazarr-Weboberfläche zu Settings → General und kopiere den API Key im Abschnitt Security.

qBt

qBt nutzt Benutzername und Passwort der Weboberfläche statt eines API-Schlüssels. Prüfe im Desktop- oder Web-Client unter Extras → Einstellungen → Weboberfläche: Die Weboberfläche muss aktiviert und von deinem iPhone oder iPad erreichbar sein, und die dort festgelegten Anmeldedaten sind die, die du in Ragnarr einträgst. Hast du „Authentifizierung für Clients auf localhost umgehen“ aktiviert, denk daran, dass das nur für localhost gilt - entfernte Clients wie Ragnarr authentifizieren sich trotzdem.

SABnzbd

Gehe zu Config → General und kopiere den API Key (den vollständigen API-Schlüssel, nicht den eingeschränkten „NZB key“, der nur Downloads hinzufügen kann).

Jellyfin, Emby

Öffne in Jellyfin das Admin-Dashboard → API-Schlüssel und erstelle einen Schlüssel für Ragnarr. Emby funktioniert genauso über den Server-Verwaltungsbildschirm. Ein eigener Schlüssel pro Client macht es einfach, später ein Gerät zu widerrufen, ohne die anderen anzufassen.

Seerr

Funktioniert mit Overseerr und Jellyseerr. Kopiere den API Key aus Settings → General in der Seerr-Weboberfläche.

Tautulli

Gehe zu Settings → Web Interface und kopiere den API key am Ende der Seite (aktiviere die API, falls sie ausgeschaltet ist).

Portainer

Erstelle ein Zugriffstoken unter My account → Access tokens. Tokens werden nur einmal bei der Erstellung angezeigt - kopiere es direkt in Ragnarr und teste die Verbindung, bevor du die Seite schließt.

Unraid

Ragnarr spricht mit Unraid über die offizielle Unraid-GraphQL-API mit einem API-Schlüssel. Erstelle einen Schlüssel in den API-Einstellungen deines Servers und füge ihn in Ragnarr ein.

Freebox

Kein API-Schlüssel nötig: Ragnarr koppelt sich direkt mit der Freebox. Füge den Dienst hinzu und bestätige dann die Autorisierungsanfrage auf dem Frontdisplay der Freebox, wenn sie erscheint.

Häufige Fehler

401 Unauthorized - der Schlüssel ist falsch, wurde regeneriert oder gehört zu einer anderen Instanz. Kopiere ihn erneut aus den Dienst-Einstellungen.
404 Not Found - der Basis-URL fehlt der URL-Base-Pfad des Dienstes, oder sie zeigt auf den falschen Port.
Timeout - die URL ist aus dem aktuellen Netzwerk deines Geräts nicht erreichbar. Teste sie zuerst in Mobile Safari; scheitert sie dort, scheitert sie auch in Ragnarr. Siehe den Tailscale/VPN-Guide für den Fernzugriff.

Sicherheitshinweise

Sende API-Schlüssel niemals per E-Mail an den Support.
Regeneriere einen Schlüssel, wenn du glaubst, ihn versehentlich geteilt zu haben.
Bevorzuge HTTPS, ein VPN oder ein vertrauenswürdiges lokales Netzwerk für den Fernzugriff.