If you want to run graim for your own community, this guide should be the one-stop spot to getting everything set up!


Getting started

First, you will need to create a Discord bot and a Matrix account (which the bot will use).

Add the bridge to your communities

Follow the tutorial here. You may also run your own bridge, and it is supported; however, that is advanced and out of the scope of this tutorial

Download graim

Open your terminal or command prompt and type these commands:

git clone
cd graim
npm install

Graim is now installed to your device - but now it needs some configuration.

Create the Discord bot

Create the Matrix bot user

Configure graim

To begin, you are going to need to run some commands.

cp graimdb.json.example graimdb.json
cd config/default.yaml.example default.yaml

Now, open config/default.yaml in your preferred text editor.

Graim is now ready for you to run it! Go back to your terminal, and run npm run start:dev.

Wait a few seconds, and you should see the bot is working!

Invite graim

Now, you have to actually add graim to the communities it is moderating.

Adding the Discord bot

Adding the Matrix bot

Adding yourself to the moderator list

In order to use any graim commands, you first need to be considered a moderator by graim itself.

NOTE: Any new moderators you add will also be able to run adduser - whether they have power level 100 or not.

Congratulations, you have set up graim!