# Whatseerr

Whatseerr is a self-hosted communication app. A self-hosted WhatsApp bot for Seerr that lets users search for and request movies and TV shows directly from WhatsApp messages. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3475/whatseerr

## Description

A self-hosted WhatsApp bot for Seerr that lets users search for and request movies and TV shows directly from WhatsApp messages. It maps phone numbers to Seerr user IDs, enforces rate limiting and message queuing, and supports webhooks for submitting requests and receiving status updates. Ideal for homelab media stacks that want mobile request access without opening a web UI. Requires a WAHA (WhatsApp HTTP API) service and a Seerr instance.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

38/100 (Low), based on 4 of 5 factors.
- Maintained: 49 (last commit 244 days ago)
- Popular: 36 (59 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 20 (1 serious finding, 16 minor, CI)

## Security check

1 serious finding: Uses proxy-addr 2.0.7, which has a known critical vulnerability.
Automated checks on commit 3edc9bc, 12 Nov 2026. Not an audit.

## Links

- Unraid: https://ca.unraid.net/apps/whatseerr-1222hkg1yi1lck?q=whatseerr
- GitHub: https://github.com/sufxgit/whatseerr

## Common questions

### What services must be running before deploying Whatseerr?

It requires a running and configured WAHA WhatsApp HTTP API service and a Seerr instance. Whatseerr is connected to both through its config file.

### Where does Whatseerr create its configuration file on first run?

On first run it creates /config/config.example.json. Rename it to config.json and set the host, Seerr API key, WAHA API key, and user mappings.

### How do I allow specific WhatsApp numbers to request media?

Add a userIdMappings entry in config.json for each phone number, using the number with country code and no @c.us suffix. Set it to the user's Seerr user ID, with an optional username and admin flag.

### Which WAHA events should I enable for the bot to work?

Point the WAHA session webhook at your Whatseerr host on port 3006 under the /requests path. Enable the session.status, message, and message.reactions events.

### How do I receive request status updates from Seerr?

Add an optional Seerr webhook for notifications such as approved, available, or declined. Point it at your Whatseerr host on port 3006 under the /seerr path and select the notification types you want.

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