# PurgeBot

PurgeBot is a self-hosted Discord bot for automated message cleanup with retention policies, a Web UI, and auto-discovery. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3234/purgebot

## Description

PurgeBot is a self-hosted Discord bot for automated message cleanup with retention policies, a Web UI, and auto-discovery. Define per-category and per-channel retention rules, and PurgeBot handles the rest on a schedule or on-demand. Built-in Web UI for managing categories, editing retention, triggering runs, and viewing real-time logs.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 77 (last commit 13 days ago)
- Popular: 18 (7 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/prophetse7en/purgebot
- Unraid: https://ca.unraid.net/apps/purgebot-0jxkd290wvf7r9?q=purgebot

## Common questions

### Can I preview what PurgeBot would delete before enabling live deletion?

Yes. The default configuration has dryRun enabled, and you should verify the dry-run output before allowing permanent deletion.

### Will PurgeBot delete messages in channels I have not configured?

No. Only channels explicitly listed in your configuration are processed, which acts as an allow-list safety guard.

### How does PurgeBot choose the retention period for a channel?

Channel overrides take precedence over category defaults, which take precedence over the global default. Per-channel options can inherit, skip, or use custom days.

### Can PurgeBot delete messages older than Discord's bulk-delete limit?

Yes. It individually deletes messages older than the 14-day Discord bulk-delete limit.

### Can cleanup be scheduled with automatic follow-up actions?

Yes. Cleanup is cron-based with timezone support, and after a run it can auto-sync, perform webhook discovery, and auto-sort.

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