Harassarr

Harassarr is a self-hosted Discord bot for media-server administrators that sends Discord and email reminders when a Plex subscription is about to expire and…

  • Automation
  • Media Applications
  • Media Servers
  • Tools & Utilities
Harassarr is a self-hosted Discord bot for media-server administrators that sends Discord and email reminders when a Plex subscription is about to expire and automatically removes lapsed users, reducing manual follow-up. The project's repository is now archived (read-only); no further maintenance or fixes are expected.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

12/100 Low

Maintained
0GitHub repository is archived
Popular
123 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 52 days ago

GitHub stars
3
Open issues
0
Last commit
2025-08-28
Latest release
1.2.0
License
GPL-3.0
Activity
stale

Checked 20 days ago - source: GitHub (mtrogman/harassarr)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Requirements Requires Docker, a Plex account, an email account for reminders, a Discord server, and a Discord bot token with channel and role management permissions. source
  • Installation and setup Deploy with Docker. Before first use, have a Plex media server, a Discord server, an email account for sending reminders, and a Discord bot token with the required permissions (e.g., Manage Channels) ready. source
  • Discord and email setup Create a Discord server and bot token, provide an email account for reminders, install via Docker, and add your media server(s) before first use. source
  • Multiple Plex servers Use the -add plex command to add additional Plex servers to Harassarr. source
  • Project status The harassarr repository has been archived by its maintainer and is no longer actively developed; the existing Docker images and links remain available and functional. source
  • Maintenance status The project's GitHub repository is archived and no longer actively maintained (last release 1.2.0). Existing deployments keep working, but expect no further updates or fixes. source

Fetched 10 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What Discord permissions must the Harassarr bot token have?

It needs Manage Channels, View Channels, Send Messages, Manage Messages, Read Message History, Add Reactions, and Manage Emojis.

How do I complete setup after running the Docker container?

Map a host folder to /config, rename config.yml.example to config.yml, and fill in the variables.

What should I know about the CSV user import?

primaryEmail is required, while primaryDiscord, secondaryDiscord, and secondaryEmail are optional. The notifyDiscord and notifyEmail fields choose Primary, Secondary, Both, or None.

How do I add extra Plex servers to Harassarr?

Use the -add plex flag when running harassarr.py.

What happens when a tracked subscription lapses?

The user is automatically removed from Plex and the Discord role.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads