Skip to content

Troubleshooting

Rules Not Working As Expected

  • Be sure you have all your services configured.
  • Be sure you have ran a full scan (especially after making changes to any services).

Seerr Requester Watch Rules Do Not Match

  • Run Sync Media after adding Seerr, changing a requester mapping, or updating a playback service.
  • Confirm the playback happened after the movie or relevant TV season was requested. Earlier playback intentionally does not count.
  • For season and series targets, one requester must have watched every required local episode; progress from multiple requesters is not combined.
  • Check that the season was actually included in the Seerr request. An un-requested season does not inherit another season's state.
  • Automatic matching uses the Seerr username, display name, and email. Add an explicit requester mapping when the playback-provider identity differs.
  • Partial playback does not count, regardless of session length. The media server's watched state or Tautulli's completed status must confirm completion.
  • Plex durable history requires Tautulli. Tautulli usernames are matched as Plex identities.
  • Declined and failed Seerr requests are ignored.

The UI Does Not Load

  • Confirm the backend is running.
  • Confirm the frontend dev server is running if you are in source mode.
  • Check that the configured API port is reachable.

Scheduled Tasks Do Not Run

  • Verify the task is enabled in Tasks.
  • Verify the task is not waiting on a main media server.
  • Check the task status and recent run history in the UI.

Reverse Proxy Problems

  • Make sure X-Forwarded-Proto reaches the app.
  • Set PROXY_TRUSTED_HOSTS to the proxy IP or CIDR.
  • Recheck Application URL in General Settings. Use redirect_uri_override only when OIDC needs a different callback.

Deletion Is Skipped

  • Protected media is skipped by design.
  • Pending protection requests block automatic deletion.
  • Pending delete requests also block automatic deletion.

A Configured Service Is Offline

You can disable or delete an existing service configuration even when the external service is unreachable. The Test action and enabling a service still require connectivity.

The active main media server is the exception: assign another media server as main before disabling or deleting it.

When deleting a Radarr or Sonarr instance, Reclaimerr disables rules assigned to that instance and removes path mappings scoped specifically to it. Review the warning shown after deletion and update those rules before re-enabling them.