Sentinel documentation

Set up protection with confidence.

Install Sentinel, configure a honeypot, test safely, and understand exactly what is retained. Features still in development are clearly marked.

Open beta guideHoneypot protection is available now
Getting started

From installation to a safe first test

Sentinel’s open beta is deliberately focused: one reliable honeypot protection system, configured per Discord server, with clear reporting and no stored message content.

01
Available now

Install Sentinel

A server owner or administrator can add Sentinel through Discord’s installation screen. Choose the correct server, review the requested permissions, and complete authorisation.

  1. Open the installer. Use the button below or the installation link on the home page.
  2. Select a server. Discord only lists servers where you can add applications.
  3. Review access. Sentinel needs message and moderation permissions only for the actions you enable.
  4. Open the dashboard. Sign in separately so Sentinel can show servers you own or manage.
Installation and dashboard sign-in are separate.

Installing adds the bot to a server. Signing in requests only your basic Discord identity and guild list. Sentinel does not request your email address.

02
Available now

Required permissions

Discord evaluates permissions per channel and by role hierarchy. A server-level permission can still be blocked by a channel override.

PermissionWhy Sentinel needs it
View ChannelDetect activity in selected honeypots and reach the incident channel.
Send MessagesPublish the persistent warning and incident reports.
Embed LinksDisplay Sentinel notices and reports in their intended format.
Read Message HistoryUpdate the persistent warning and process channel activity reliably.
Manage ChannelsCreate a honeypot or private incident channel when requested during guided setup.
Manage MessagesDelete the triggering message for enforcement modes.
Moderate MembersApply the configured timeout action.
Ban MembersPerform a soft-ban and immediately remove the ban.
Role order matters.

Place Sentinel above ordinary members it may need to action. It cannot moderate the server owner, administrators, or members whose highest role is equal to or above its own.

03
Available now

First-time setup

Run /sentinel setup for a private, guided setup inside Discord. Sentinel can use existing channels or create a named honeypot and a private sentinel-logs channel after you review and confirm every choice.

  1. Choose or create the honeypot channel.
  2. Leave the action on Observe and report only for the first test.
  3. Choose a separate staff-only incident channel or let Sentinel create one.
  4. Review the complete configuration.
  5. Confirm. Only then will Sentinel create channels, save protection, and publish its warning.

After setup, use /sentinel settings to view or change the shared action and incident destination. Use /sentinel honeypot add, create, remove and list to manage channels. Adding channels preserves settings and safe testers. Rerunning setup shows the existing configuration.

You can also configure existing channels from Your servers. The free open-beta plan supports one honeypot. Clearing the dashboard selection disables honeypot protection without removing Sentinel.

Honeypot protection
04
Available now

How honeypots work

A honeypot is a channel legitimate members have no reason to use. Automated spam accounts often post across every visible channel, so touching the trap provides a high-confidence signal without interpreting normal conversation.

1

A message appears in a configured restricted channel.

2

Sentinel checks exemptions. Server managers and administrators do not trigger enforcement.

3

The configured action runs. Sentinel records the actual outcome, not merely the requested action.

4

A report is sent. The triggering message body is never retained.

05
Available now

Channel naming and access

Use a restricted name an automated account might encounter, while clearly warning real members not to interact. Examples include #restricted-access, #system-reserved, or #do-not-post.

  • Keep the channel visible but clearly restricted for ordinary members.
  • Do not use it for real announcements, verification, or staff conversation.
  • Keep incident reports in a different, staff-only channel.
  • Do not remove or contradict Sentinel’s persistent warning.
06
Available now

Enforcement actions

ModeBehaviourBest use
ObserveReports the incident without modifying the message or member.Initial setup and testing.
DeleteDeletes the trigger without actioning the member.Low-risk containment.
TimeoutApplies the configured timeout duration and attempts to delete the trigger.Temporary containment.
Soft-banBans the member, clears recent messages, then immediately unbans them.High-confidence spam.

If Discord blocks part of an action, Sentinel reports whether it succeeded, partially completed, or failed. A failed automatic unban is reported as partial so moderators know the member remains banned.

07
Available now

Test safely

  1. Open the server dashboard and add your test account's Discord user ID under Individual safe testers, or select a trusted safe tester role and confirm the bypass warning.
  2. Post a harmless message in the honeypot from that account.
  3. Confirm the staff report is labelled as a safe test and shows that no enforcement was attempted.
  4. Remove the account from the safe list only when you deliberately want to test real enforcement.

Safe testers can include server administrators, who Sentinel otherwise ignores. Their test incidents are retained under the same 30-day policy but are not included in public threat totals.

Do not test soft-ban with your owner or primary administrator account.

Discord role hierarchy and Sentinel’s administrator exemption make those accounts unsuitable for enforcement tests.

Operations and privacy
08
Available now

Incident reporting

During open beta, Sentinel sends an immediate report for every trigger. It identifies the member and channel in Discord, configured response, actual outcome, a safe failure code when relevant, and an incident ID.

No message content is retained.

Reports explain what happened without copying the triggering message into Sentinel’s database.

Noise controls

Weekly aggregate summaries, dashboard-only reporting, and immediate-plus-weekly reporting are planned as free usability choices. A weekly summary will contain totals and outcomes, not a delayed list of named incidents.

Coming soon
09
Available now

Dashboard guide

The dashboard lists only servers Discord says you own or can manage. For each installed server you can select the honeypot, enforcement action, and incident-report channel.

Protection status
Whether a honeypot is configured and which action is active.
Channel limit
How many honeypots the current entitlement allows.
Installation required
You can manage the server, but Sentinel is not installed there.

Recent incident history will appear here after its authorised API endpoint is ready.

Incident history coming soon
10
Available now

Premium codes

A server owner, administrator, or member with Manage Server can privately redeem a Sentinel premium code with /sentinel premium redeem. Regular members cannot activate a server-wide entitlement.

  • Codes have a fixed premium duration, redemption deadline, and total usage cap.
  • The same code can never be redeemed more than once for the same server, even by a different administrator later.
  • Codes cannot be stacked while premium is already active.
  • Use /sentinel premium status to see the current tier, source, expiry date, and remaining validity.
Redemption is private.

Both premium commands respond ephemerally, so a code is not posted into the server channel.

11
Available now

Privacy and retention

Sentinel stores only what is required to explain and operate protection:

  • Guild and channel identifiers.
  • A keyed pseudonymous subject reference instead of a recoverable Discord user ID.
  • Configured action, actual outcome, safe failure code, reason, incident ID, and timestamp.
  • No message body, attachment, Discord OAuth token, or email address.

Raw incidents are automatically deleted after 30 days. Cleanup runs at startup and every 24 hours.

Read the full privacy notice →
12
Reference

Troubleshooting

Sentinel does not react to my test

Confirm the channel is saved, use a non-administrator account, and ensure Sentinel can view the channel. Server managers are exempt.

The dashboard cannot save protection

Check View Channel, Send Messages, Embed Links, and Read Message History. Sentinel must create or update its warning before saving.

Timeout or soft-ban failed

Move Sentinel above the test member’s role and verify Moderate Members or Ban Members. The report should show the actual result.

A server is missing from my dashboard

Sign out and back in for a fresh guild list. You must own it or hold Administrator or Manage Server.

13
Coming soon

Planned protection and controls

These are roadmap items, not active open-beta protection.

Reporting

Noise controls

Weekly aggregates, dashboard-only mode, and immediate plus weekly reports.

Dashboard

Incident history

A 30-day view of requested actions and actual outcomes.

Onboarding

Setup templates

Reusable channel placement and staff-role presets for larger communities.

Security

Link Shield

Layered local rules, Sentinel intelligence, and external reputation checks.

Security

Spam detection

Focused coordinated image and message-spam detection.

Discord

Guided maintenance

Edit individual settings without rerunning the complete setup flow.