# Boxwatchr

Boxwatchr is a self-hosted automation app. A self-hosted email filtering daemon that watches your IMAP mailbox, scores every incoming message with a spam engine, runs it through your custom rules, and takes action automatically. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2376/boxwatchr

## Description

A self-hosted email filtering daemon that watches your IMAP mailbox, scores every incoming message with a spam engine, runs it through your custom rules, and takes action automatically. No cloud, no subscriptions, just your server doing exactly what you tell it to.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

35/100 (Low), based on 4 of 5 factors.
- Maintained: 50 (last commit 225 days ago)
- Popular: 23 (13 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 20 (1 serious finding, 8 minor, CI)

## Security check

1 serious finding: Uses certifi 2026.2.25, which has a known critical vulnerability.
Automated checks on commit 4b41a00, 19 Nov 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/nulcraft/boxwatchr
- GitHub: https://github.com/nulcraft/boxwatchr
- Unraid: https://ca.unraid.net/apps/boxwatchr-15ap6x40m8azb8?q=boxwatchr

## Common questions

### Do I need to install rspamd separately before running boxwatchr?

No. The Docker image bundles Python, Redis, rspamd, and the DNS resolver, so you only need Docker or Docker Compose and an IMAP-capable email account.

### Can I see what boxwatchr would do before it starts moving or flagging mail?

Yes. Dry run mode shows the actions boxwatchr would take before you let it act for real.

### Do I need to restart the container after changing a rule?

No. Rule changes take effect immediately without a restart.

### What should I back up for boxwatchr?

Back up the two persistent host directories used by the setup: one for config and one for data.

### What happens if my IMAP server does not support IDLE?

boxwatchr uses IMAP IDLE for real-time monitoring, with polling fallback if your server does not support it.

### Can I provide environment variables from a file when using Docker run?

Yes. Add --env-file with the path to the env file before the image name.

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