Self-hosted · Open source · Discord

Moderation, with guardrails.

Sentinel gives Discord server staff a clear toolkit for timed role actions, warnings, and member applications—with an authenticated dashboard for the work behind the scenes.

Get the latest release Explore source
  • Python
  • Windows · macOS · Linux
  • Self-hosted
  • SQLite
One command groupStaff tools organized under /manage
Run it where you chooseYour host. Your configuration. Your records.
Built for real serversWindows, macOS, Linux, and ARM64

Made for the day-to-day

A focused toolkit for server staff.

Keep routine moderation and application decisions in one self-hosted bot, with records stored on the machine you control.

Measured moderation

Timed role punishments, pardons, and warnings use staff checks and role safeguards. View a member’s recorded history when context matters.

Staff-reviewed applications

Create forms, publish an application panel, and review submissions with authorized staff. Decisions and optional roles follow the server’s setup.

Authenticated dashboard

Manage connected servers, moderation, applications, settings, and history in a web dashboard that listens on the local machine by default.

Persistent local records

SQLite keeps active punishment timers available after a restart and holds warning, history, and application records on your host.

Installation & Setup

Deploy Sentinel on your host.

Cross-platform Discord bot running locally on Python 3.9+ with SQLite storage and web management dashboard.

Installation Steps

  1. 1. Clone the repository

    git clone https://github.com/mob5824m-wq/Sentinel.git && cd Sentinel

  2. 2. Install Python requirements

    python3 -m pip install -r requirements.txt
    Requires Python 3.9 or higher.

  3. 3. Configure Discord Bot Token

    export DISCORD_TOKEN="your-bot-token"
    Or configure directly in data/config.json.

  4. 4. Run Sentinel

    python3 bot.py
    Or execute scripts/run_linux.sh (Linux/macOS) or scripts\run_windows.bat (Windows).

How to Use

  1. 1. Enable Gateway Intents in Discord Portal

    Enable Server Members Intent and Message Content Intent under your Discord application's Bot settings.

  2. 2. Initial server configuration

    /manage setup staff_role:@Staff log_channel:#staff-log timezone:America/Toronto

  3. 3. Moderation & Warnings

    /manage punish user:@User role:@Muted duration:2h reason:Spamming
    Use /manage warn, /manage pardon, and /manage status.

  4. 4. Staff Dashboard

    Access http://localhost:8000 in your browser using the token generated during startup to manage history, punishments, and applications.

From install to /manage

Your server, your rules.

01 / INSTALL

Choose a build

Download a release for Windows, macOS, or Linux—or follow the setup guide to run from source.

02 / CONFIGURE

Set the guardrails

Connect your Discord application, configure staff access and roles, then add any application forms your server needs.

03 / OPERATE

Manage with confidence

Use Sentinel’s /manage commands or its protected dashboard. Server staff stay responsible for every decision.

Ready to run Sentinel?

Read the current setup instructions and security notes before exposing a dashboard beyond the host.

Read the setup guide
Sentinel Terms of Service Sentinel Privacy Policy GitHub repository ↗