Skip to content

Configuration

trigg edited this page Apr 19, 2026 · 3 revisions

Setup

Before first run be sure to copy config-example.json to config.json and change the contents accordingly

storage

You can choose which storage backend is used by this instance. Each backend has distinct advantages and disadvantages and comparing these is beyond the scope of this page.

Currently working backends:

  • json
  • sqlite
  • mysql

port

Which port to run this server on. We default to 9000 but the server connects using HTTPS and WSS, so binding port 443 allows omitting the port number in the URL.

servername

A String which shows up directly underneath the server logo to help users confirm they are connecting to the correct server.

serverimg

A locally hosted image to use as the server logo. Must be relative to the server root directory named "public"

gravatarfallback

Which Default Image to use when the user has not set a gravatar. One of mp, identicon, monsterid, wavatar, retro, robohash, blank

Options may be added or removed by Gravatar.

plugins

A list of strings. Each of these are extra plugins loaded from /plugin to add extra features to the server

Environment

Some options can be set by environment variable.

mysql Storage specific options

REBUTTAL_MYSQL_USERNAME

The username to use to connect to the MySQL server

REBUTTAL_MYSQL_PASSWORD

The password to use to connect to the MySQL server

REBUTTAL_MYSQL_DATABASE

The database to use in the MySQL server

REBUTTAL_MYSQL_HOST

The host on which the MySQL Server is running

TEST_MYSQL

Specifically used by the yarn test to ensure MySQL tests are run too. Considered true if set to any value

Clone this wiki locally