Skip to content

Hosting

You can use our docker image or do manual stuff setting the bot up.

Docker

Use the docker compose file in the docker directory.

Normal hosting

You will need a PostgreSQL database and Java 18 or higher installed already.

Detailed setup guide for non docker users.

We provide a bash script for setting up all requirements for the reputation bot. We do not install any databases or java for you.

Once the setup is complete you can simply execute the start.sh to start the bot in a screen called repbot.

Simple Setup

See what's inside

wget -q --no-cache https://gist.githubusercontent.com/RainbowDashLabs/20d7ad959b524056a406aeb6ee53b4e2/raw/setup.sh && chmod +x setup.sh && ./setup.sh

Manual setup

Execute the commands from this gist by hand.

Configuration

After the first start the bot will create a configuration file.

config/config.json

  1. Create a bot account with message and guild members intent.
  2. Enter your bot token
  3. Adjust the database login credentials
  4. Enter your user id to the bot owners

config/log4j2.xml

  1. Create a private channel with a webhook.
  2. Paste the webhook url into the verbose webhook appender url field
<DiscordWebhook name="DiscordVerbose" url="<your webhook here>">
  1. You can create additional webhooks for the two more log levels.

Managing

The bot can be managed by commands located under the bot slash command, which will be only available on the bot guild defined in the config file.

  • upgrade -> Upgrade the bot on the latest stable version (Not supported when using docker)
  • restart -> Restarts the bot process
  • shutdown -> Stops the bot and ends the loop.
  • stats -> Shows stats about bot usage