Skip to main content

Maintainerr integration

Purpose

Maintainerr is used for scheduled deletions and cleanup review. In PlexSub it is an optional beta module.

It appears in PlexSub at:

  • Admin: /maintainerr
  • Customer Portal: scheduled deletions

Requirements

  • Plex configured.
  • A working Maintainerr instance.
  • A URL reachable from PlexSub.
  • A valid API key.

Related variable: MAINTAINERR_URL. The API key is handled by the service's apiKey profile.

Dependencies

The service registry declares a dependency on Plex.

  1. Configure Maintainerr and its rules outside PlexSub.
  2. Confirm Maintainerr detects content correctly.
  3. Configure the URL and API key in PlexSub.
  4. Run diagnostics.
  5. Review scheduled-deletion views before exposing them to customers.

Troubleshooting

SymptomLikely causeResolution
No deletions appearMaintainerr has no rules or dataCheck rules in Maintainerr.
PlexSub cannot connectIncorrect URL/API keyCorrect the configuration.
A customer sees unexpected dataMapping or policy was not reviewedValidate with a test user.