Jellyfin integration
Purpose
Jellyfin is a beta media-server module. PlexSub uses it as an optional provider of media identity, libraries, history, usage, and customer status.
It appears in PlexSub at:
- Admin:
/jellyfin - Customer Portal: general status, downloads, playback history, and usage
Requirements
- A Jellyfin URL reachable from PlexSub.
- A valid API key or token.
- Users and libraries configured in Jellyfin.
Related variables:
JELLYFIN_URLJELLYFIN_API_KEYJELLYFIN_TOKEN
Recommended configuration
- Confirm Jellyfin responds from the Docker network.
- Create or copy a valid API key.
- Configure Jellyfin in Settings > Services.
- Enable the module if it is paused.
- Run diagnostics and confirm PlexSub detects the service.
Module status
In the service registry, Jellyfin is marked as required within the media-server group, beta, pausable, and visible in the sidebar when enabled.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Service disabled | Module paused or credentials missing | Enable it and save the URL/API key. |
| Users do not appear | Insufficient credentials | Check API-key permissions. |
| Incomplete history | Missing statistics provider or Jellyfin data | Check Jellyfin and Jellystat, if used. |
| Certificate error | HTTPS URL with an untrusted certificate | Use a valid certificate or correct proxy. |