Scanner
Scanner is an admin-only, Autoscan-inspired library refresh built into the portal. It does not require a separate Autoscan container.
What it does
- Receives Sonarr / Radarr / Lidarr webhooks (and manual paths).
- Rewrites paths as configured.
- Queues folder scans with a configurable minimum age.
- Sends partial library refreshes to Plex, Jellyfin, and/or Emby.
Enable
- Open Settings → Scanner.
- (Optional) Use Import from Autoscan — upload or paste your Autoscan
config.ymlto fill auth, triggers, and rewrites. Plex URL/token still come from Settings → Plex. - Turn Enable Scanner on (if not already).
- Optionally turn on Show Home Widget for a queue/activity card on Home (admins).
- Optionally turn off Show ARR Webhooks on Scanner Page if you don’t want the webhook URL helper block on the Scanner page.
- Optionally turn off Show Manual Path on Scanner Page if you only use ARR webhooks (when shown, it can still be collapsed on the page).
- Review webhook username/password and rewrites, then Save Settings.
- Open Scanner in the nav.
Manual scan
On the Scanner page, enter a filesystem path and click Submit. The path is added to the queue and processed after the minimum age (and after path existence checks if that toggle is on).
ARR Connect
For each *arr app:
- Settings → Connect → Webhook
- On Import + On Upgrade
- URL examples (same host as the portal):
/triggers/sonarr/triggers/radarr/triggers/lidarr
- Username / password = Scanner webhook credentials
Notes
- Webhooks use HTTP Basic Auth, not portal login cookies.
- Plex scans use the token and server URL from Settings → Plex (no separate Scanner token).
- The direct Plex server URL is required (e.g.
http://192.168.x.x:32400). plex.tv login alone is not enough — without it you will see “no enabled scanner targets”. - Queue and activity logs live under
config/scanner/. - Recent activity shows why a refresh ran (import, upgrade, file delete, rename, manual) when the ARR webhook includes that event type.