Ragnarr non crea né inoltra alcuna credenziale. Per ogni servizio, copia la chiave API (o le credenziali) dalla schermata delle impostazioni del servizio stesso, incollala in Ragnarr, poi usa Testa connessione prima di salvare. L'URL di base è sempre l'indirizzo che digiteresti in un browser per raggiungere il servizio, ad esempio https://sonarr.example.com o http://192.168.1.50:8989.

Sonarr, Radarr, Lidarr, Prowlarr

Apri l'interfaccia web del servizio, vai in Settings → General e copia il valore del campo API Key (nella sezione Security). La chiave è una stringa di 32 caratteri. Se la rigeneri lì, ogni client che usa la vecchia chiave - Ragnarr compreso - smette di funzionare finché non lo aggiorni.

Se il servizio è configurato con una URL Base (ad esempio /sonarr per il reverse proxy basato su percorso), includila nell'URL di base che fornisci a Ragnarr: https://media.example.com/sonarr.

Bazarr

Nell'interfaccia web di Bazarr, vai in Settings → General e copia l'API Key nella sezione Security.

qBt

qBt usa il nome utente e la password dell'Interfaccia web invece di una chiave API. Nel client desktop o web, controlla Strumenti → Opzioni → Interfaccia web: l'Interfaccia web deve essere attiva e raggiungibile dal tuo iPhone o iPad, e sono queste le credenziali da inserire in Ragnarr. Se hai attivato «Ignora l'autenticazione per i client su localhost», ricorda che vale solo per localhost - i client remoti come Ragnarr si autenticano comunque.

SABnzbd

Vai in Config → General e copia l'API Key (la chiave API completa, non la «NZB key» limitata che può solo aggiungere download).

Jellyfin, Emby

In Jellyfin, apri la Dashboard di amministrazione → Chiavi API e crea una chiave per Ragnarr. Emby funziona allo stesso modo dalla schermata di gestione del server. Una chiave dedicata per ogni client permette di revocare un dispositivo in seguito senza toccare gli altri.

Seerr

Funziona con Overseerr e Jellyseerr. Copia l'API Key da Settings → General nell'interfaccia web di Seerr.

Tautulli

Vai in Settings → Web Interface e copia l'API key in fondo alla pagina (attiva l'API se è disattivata).

Portainer

Crea un token di accesso da My account → Access tokens. I token vengono mostrati una sola volta alla creazione - copialo subito in Ragnarr e testa la connessione prima di chiudere la pagina.

Unraid

Ragnarr dialoga con Unraid tramite l'API GraphQL ufficiale di Unraid, con una chiave API. Crea una chiave dalle impostazioni API del tuo server e incollala in Ragnarr.

Freebox

Nessuna chiave API necessaria: Ragnarr si associa direttamente alla Freebox. Aggiungi il servizio, poi approva la richiesta di autorizzazione sul display della Freebox quando compare.

Errori comuni

  • 401 Unauthorized - la chiave è errata, è stata rigenerata o appartiene a un'altra istanza. Ricopiala dalle impostazioni del servizio.
  • 404 Not Found - l'URL di base non include il percorso URL Base del servizio, oppure punta alla porta sbagliata.
  • Timeout - l'URL non è raggiungibile dalla rete attuale del tuo dispositivo. Provalo prima in Safari mobile; se fallisce lì, fallirà in Ragnarr. Consulta la guida Tailscale/VPN per l'accesso remoto.

Note di sicurezza

  • Non inviare mai le chiavi API al supporto via e-mail.
  • Rigenera una chiave se pensi di averla condivisa per sbaglio.
  • Preferisci HTTPS, una VPN o una rete locale fidata per l'accesso remoto.

Guide correlate

Torna a tutte le guide, oppure consulta le FAQ di supporto per la risoluzione dei problemi di connessione.