Setting up Draupnir

This page describes how to setup Draupnir as a bot user that runs against any Matrix homeserver. This includes homeservers that you do not administer.

Overview

There are a number of steps to complete to get Draupnir running:

1. Create an account for Draupnir to use.
   • Optionally disabling rate limits for this account.
2. Review our notes on encryption.
3. Create a management room for Draupnir to use.
4. Install Draupnir on your system.
5. Fill out Draupnir's config file to complete the installation.
6. Start using Draupnir by referring to the moderator's guide.

Installation

Draupnir can be installed in three ways, via Docker, building it yourself from source, or via matrix-docker-ansible-deploy.

tip

We strongly recommend new or inexperienced system administrators to follow our guide for installation with Docker and systemd. If you are preparing to administer a new homeserver, then we strongly recommend using matrix-docker-ansible-deploy.

See the following links for corresponding installation documentation:

• Installation with Docker and systemd - The recommended and supported setup for users who do not wish to use matrix-docker-ansible-deploy.
• matrix-docker-ansible-deploy - the most convenient way to run Matrix services. Recommended if you are preparing a new homeserver or are already using matrix-docker-ansible-deploy.
• Installation on Debian - Installation on debian by using NodeSource.
• Advanced Docker setup - for experienced system administrators.
• Advanced setup from source - for experienced system administrators.