PurgeBot
PurgeBot is a self-hosted Discord bot for automated message cleanup with retention policies, a Web UI, and auto-discovery.
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.
50/100 Fair
- Maintained
- 77last commit 13 days ago
- Popular
- 187 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 19 days ago
- GitHub stars
- 7
- Open issues
- 2
- Last commit
- 2026-11-08
- Latest release
- v1.5.0
- License
- MIT
- Activity
- rising
Checked 6 days ago - source: GitHub (prophetse7en/purgebot)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Start with dry-run enabled PurgeBot permanently deletes Discord messages with no undo. The default config uses dryRun: true — always verify dry-run output before enabling live deletion. Only channels explicitly listed in your config are processed (allow-list safety). source
- Dry-run safety Verify the dry-run output before enabling live deletion, because Discord permanently deletes messages and provides no undo function. source
Fetched today - each note links to its source
Variants
Alternatives
No alternatives collected yet.
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.
Answers sourced from github.com
Community
- Reddit (reddit)
- overview for Purgebot - Reddit (reddit)
Collected 49 days ago - public community threads