Creating an account for Draupnir
If you want Draupnir to be a Synapse admin, you might want to create
the account using Synapse's register_new_matrix_user
command.
See the Synapse documentation here.
If you are not using encrypted rooms anywhere, you can get an access
token by opening Element in a separate browser profile or incognito
tab and logging in as the bot or registering an account. Once you are
logged in, go to "All Settings", "Help & About", and click the little
triangle next to "Access token". Copy and paste that into your
config file under the accessToken
key.
Do not log out, just close the window, otherwise the access token will be invalidated.
If you have presence enabled on your homeserver, do not keep the window open or use the same session to login to the Draupnir account as this will cause you to accidentally trigger a bug in Synapse or Element web that will flood presence updates.
Disabling rate limiting
While Draupnir can be run on a rate limited account without issue. We recommend disabling rate limiting if the option is available to you.
By default, Draupnir will be rate limited by Synapse, which can inhibit Draupnir's ability to respond in some scenarios, particularly while redacting lots of messages.
It's therefore recommended to turn off ratelimiting for a draupnir bot, see the synapse admin API documentation for more information.
Making Draupnir a Synapse Admin
To deactivate users, move aliases, and shutdown rooms, Draupnir will need to be a server admin. These features are only supported on Synapse.
If you registered a new account, please see the Synapse documentation for how to make an existing account a Synapse admin here.