Skip to content

Troubleshooting

Jump to bottom
Harry Elliott edited this page Apr 6, 2026 · 1 revision

Troubleshooting

Nothing shows up after scanning

Make sure your Plex URL and token are correct. The token needs to be for the server owner account, not a shared user. Check Settings > Service Status — Plex should show as connected with a green dot.

Watch history isn't working

You need either Tautulli or Tracearr configured. Plex on its own only tracks the server owner's watches — shared users' history won't show up without a dedicated watch history provider.

If you've just set up Tautulli, make sure it has had time to build its history database. Prunerr pulls from Tautulli's API, so if Tautulli doesn't have the data yet, Prunerr won't either.

Rules aren't matching anything

A few things to check:

  • Is the rule enabled? (Toggle on the Rules page)
  • Does the rule's media type filter match your content? (Movies vs TV Shows vs All)
  • Run the rule manually and check the preview — it shows exactly what would match
  • If you're using watch-based conditions, make sure your watch history provider is connected

Collections aren't showing up

Collections come from Radarr, not Plex. Make sure Radarr is connected, then hit Sync Collections on the Collections page. Only movie collections are supported (Sonarr doesn't have a collections concept).

Items show as protected but I didn't protect them

They're probably in a protected collection. Check the "Protected" badge on the item — it'll show the collection name. Click it to go to that collection.

API returns 401

You need to include your API key in the X-Api-Key header. Get your key from Settings > API Key in the web UI.

High CPU/memory usage

If your library is very large (5000+ items), the first scan takes a while. Subsequent scans are faster since they only check for changes. If it's consistently slow, check your Plex server's response times in the Service Status panel.

Database issues

The SQLite database is at /app/data/prunerr.db inside the container. If you need to reset everything, stop the container and delete this file. Prunerr will recreate it on next startup (but you'll lose all your rules, history, and settings).

Getting help

Clone this wiki locally