PurgeBot

PurgeBot is a self-hosted Discord bot for automated message cleanup with retention policies, a Web UI, and auto-discovery.

  • Automation
  • Productivity
  • Tools & Utilities
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
  • 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

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

Collected 49 days ago - public community threads