# 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 automatically removes lapsed users, reducing manual follow-up. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/859/harassarr

## Description

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.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

12/100 (Low), based on 3 of 4 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/mtrogman/harassarr
- Docker Hub: https://hub.docker.com/r/mtrogman/harassarr
- Unraid: https://ca.unraid.net/apps/harassarr-09jffut08pligp?q=harassarr

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/859/harassarr), the self-hosted and open-source app directory.