Ragnarr no crea ni retransmite ninguna credencial. Para cada servicio, copia la clave API (o las credenciales) desde la pantalla de ajustes del propio servicio, pégala en Ragnarr y usa Probar conexión antes de guardar. La URL base es siempre la dirección que escribirías en un navegador para llegar al servicio, por ejemplo https://sonarr.example.com o http://192.168.1.50:8989.

Sonarr, Radarr, Lidarr, Prowlarr

Abre la interfaz web del servicio, ve a Settings → General y copia el valor del campo API Key (en la sección Security). La clave es una cadena de 32 caracteres. Si la regeneras allí, todos los clientes que usan la clave antigua -incluido Ragnarr- dejan de funcionar hasta que la actualices.

Si el servicio está configurado con una URL Base (por ejemplo /sonarr para un reverse proxy por ruta), inclúyela en la URL base que le das a Ragnarr: https://media.example.com/sonarr.

Bazarr

En la interfaz web de Bazarr, ve a Settings → General y copia la API Key de la sección Security.

qBt

qBt usa el usuario y la contraseña de la interfaz web en lugar de una clave API. En el cliente de escritorio o web, revisa Herramientas → Opciones → Interfaz web: la interfaz web debe estar activada y ser accesible desde tu iPhone o iPad, y esas credenciales son las que hay que introducir en Ragnarr. Si activaste «Omitir autenticación para clientes en localhost», recuerda que solo se aplica a localhost: los clientes remotos como Ragnarr se autentican igualmente.

SABnzbd

Ve a Config → General y copia la API Key (la clave API completa, no la «NZB key» limitada, que solo puede añadir descargas).

Jellyfin, Emby

En Jellyfin, abre el Panel de administración → Claves API y crea una clave para Ragnarr. Emby funciona igual desde la pantalla de gestión del servidor. Una clave dedicada por cliente facilita revocar un dispositivo más adelante sin tocar los demás.

Seerr

Funciona con Overseerr y Jellyseerr. Copia la API Key desde Settings → General en la interfaz web de Seerr.

Tautulli

Ve a Settings → Web Interface y copia la API key al final de la página (activa la API si está desactivada).

Portainer

Crea un token de acceso desde My account → Access tokens. Los tokens solo se muestran al crearlos: cópialo directamente en Ragnarr y prueba la conexión antes de cerrar la página.

Unraid

Ragnarr se comunica con Unraid mediante la API GraphQL oficial de Unraid, con una clave API. Crea una clave desde los ajustes de API de tu servidor y pégala en Ragnarr.

Freebox

No hace falta clave API: Ragnarr se empareja directamente con la Freebox. Añade el servicio y luego aprueba la solicitud de autorización en la pantalla de la Freebox cuando aparezca.

Errores habituales

  • 401 Unauthorized: la clave es incorrecta, se regeneró o pertenece a otra instancia. Vuelve a copiarla desde los ajustes del servicio.
  • 404 Not Found: la URL base omite la ruta URL Base del servicio o apunta al puerto equivocado.
  • Timeout: la URL no es accesible desde la red actual de tu dispositivo. Pruébala primero en Safari móvil; si falla ahí, fallará en Ragnarr. Consulta la guía de Tailscale/VPN para el acceso remoto.

Notas de seguridad

  • No envíes claves API por correo al soporte.
  • Rota una clave si crees que se compartió por accidente.
  • Prioriza HTTPS, una VPN o una red local de confianza para el acceso remoto.

Guías relacionadas

Volver a todas las guías, o consulta las FAQ de soporte para resolver problemas de conexión.