Overview

Automated Discord message cleanup with retention policies, 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.

Requirements

Discord bot token and server (guild) ID. See project page for setup instructions.

Runtime arguments

Web UI: http://[IP]:[PORT:3050]
Network: bridge
Shell: sh
Privileged: false

Template configuration

WebUIPorttcp

Web UI port

Target: 3050
Default: 3050
Value: 3050

Config PathPathrw

Config, logs, and stats storage

Target: /config
Default: /mnt/user/appdata/purgebot
Value: /mnt/user/appdata/purgebot

Discord TokenVariable

Bot token from Discord Developer Portal

Target: DISCORD_TOKEN

Guild IDVariable

Discord server (guild) ID

Target: GUILD_ID

PUIDVariable

User ID for file ownership

Default: 99
Value: 99

PGIDVariable

Group ID for file ownership

Default: 100
Value: 100

UMASKVariable

File creation mask

Default: 002
Value: 002

Links

Template Support Registry Project

Details

Repository

ghcr.io/prophetse7en/purgebot:latest

Registry

https://github.com/prophetse7en/purgebot/pkgs/container/purgebot

Last Updated2026-05-31

First Seen2026-03-29

Run Purgebot on Unraid.

Purgebot is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS

purgebot