Draupnir bot

The Draupnir bot installed by us is powered by draupnir.

• Full documentation
• Source code
• Support

Draupnir is a moderation bot for Matrix that helps you keep your rooms and communities safe, clean, and friendly.
Think of it as a security guard for your Matrix rooms — always on duty, always ready to step in when trouble shows up.

This component is mandatory if you want to have a Matrix server with open registration, and strongly recommended for all Matrix servers, even those with closed registration.

What does Draupnir do?¶

Moderating a Matrix community can be hard work, especially if your rooms are public or attract a lot of people. Draupnir automates much of that work and gives you easy commands to handle the rest.

With Draupnir you can:

• Ban and remove troublemakers quickly — and delete their messages so they don’t linger.
• Block harmful or unwanted content using word lists, link filters, or custom rules.
• Prevent spam and flooding by limiting how often users can post or how many people they can mention at once.
• Stop malicious events that could crash clients or break the room.
• Moderate across multiple rooms from a single, private control room.

Who is it for?¶

Draupnir is a great fit for:

• Public chat rooms that need to stay friendly and on-topic.
• Large communities where moderators can’t watch every room at once.
• Homeserver admins who want consistent moderation across all their rooms.
• Homeservers with open registration.

Whether your Matrix space is a fan club, an activist hub, a developer group, or a casual hangout — Draupnir helps keep it safe.

Usage¶

Getting Started¶

To start using Draupnir, you need to have it installed on your Matrix homeserver. New customers (without a homeserver) can select Draupnir directly in the order form, while existing customers can add it by contacting us.

Draupnir is a pretty complex solution with numerous of features and settings, so we strongly recommend to read the Draupnir documentation before starting to use it.

The steps below will help you to set up Draupnir and start using it in your rooms. Please note that the policies and protections mentioned below are prepared by us based on our experience, Draupnir developers’ recommendations, and community moderators’ feedback. We strongly recommend precisely following these steps to ensure your rooms are protected from spam, CSAM, and other illegal content (yes, even on servers with closed registration. A single public room is enough to flood your server with man-made horrors beyond your comprehension).

1. Create an unencrypted private management room
2. Share the room ID with us
3. Once management room is set in Draupnir, invite @draupnir:your-server.com to the management room
4. Assign Draupnir the admin role in the management room (power level 100)
5. (Mandatory) Send the following command to the management room to subscribe to the Community Moderation Effort - suggested by the Draupnir developers, and community moderators (it may take a few minutes to process; if command fails, just resend it in a minute):

!draupnir watch #community-moderation-effort-bl:neko.dev?via=etke.cc&via=devture.com&via=codestorm.net&via=feline.support&via=envs.net

6. (Mandatory) Send the following command to the management room to subscribe to the Active Threats policy - managed by community moderators to maintain a fast response to active threats and spam attacks (it may take a few minutes to process; if command fails, just resend it in a minute):

!draupnir watch #huginn-muninn-active-threats:feline.support?via=etke.cc&via=devture.com&via=codestorm.net&via=maunium.net&via=envs.net

7. (Mandatory for public Matrix servers) Send the following command to the management room to suspend (not ban) users of your homeserver who were reported in the policies you subscribed to:

!draupnir protections enable HomeserverUserPolicyProtection

8. (Optional, recommended) Send the following command to the management room to ban users who send an image or video right after joining a room (common spam tactic, you definitely do not want to see what that image/video contains):

!draupnir protections enable FirstMessageIsImageProtection

9. (Optional, recommended) Send the following command to the management room to automatically redact messages (not ban users) that contain more than 3 mentions (common spam tactic, used to annoy users and force them to leave the room):

!draupnir protections enable MentionLimitProtection

10. (Optional, recommended) Send the following command to the management room to automatically rate-limit users who send more than 7 membership changes (e.g., sending mass invites, etc.) in 1 hour (common spam tactic, used to bring as many people as possible to the spammer’s room):

!draupnir protections enable MembershipChangeProtection

You are ready to go!

Ongoing Usage¶

To protect your rooms, you need to invite @draupnir:your-server.com to each room you want it to moderate and assign it the admin role (power level 100). After that Draupnir will automatically apply its moderation rules to the room.

Please note that sometimes Draupnir may report errors like ‼ | Error while trying to redact messages for BAD_ACTOR in YOUR_ROOM: Error: ESOCKETTIMEDOUT — don’t worry, this is normal and happens when Draupnir attempts to process a large number of rules or messages at once. Usually that may happen during the initial setup, but it should not affect the ongoing moderation of your rooms

There is an awesome community handbook that contains step-by-step instructions for cases when your server sends (or receives) spam/illegal content and you need to take action fast. It is a great resource to have at hand, so we recommend reading it and keeping it bookmarked!

Policies¶

Matrix community already coordinated and created various shared moderation policies, which you can use to set up Draupnir. By default, we recommend using the Community Moderation Effort policy, which is a good starting point for everyone, because CME is a trusted and well-known policy in the Matrix community, that focuses on unambiguous, specific and clear rules, that are acceptable everywhere (spam, obvious scams, CSAM, etc).

However, there are many other policies available, which you can use to set up Draupnir according to your needs.

We strongly recommend reading Draupnir documentation about policies and how to use them.