1
Fork 0
mirror of https://github.com/wlinator/luminara.git synced 2024-10-02 18:03:12 +00:00
Lumi/README.md
2024-03-29 13:17:51 -04:00

2 KiB

You can invite me with this link. Thanks for using Racu!

Racu art

Self host

The next part of this README explains how to self-host Racu, this allows you to host your own version of my code and create a personalized Discord bot.

📲 Installation

Racu is containerized: its core, database, database admin platform and logger run on Docker without any extra configuration. However, you CAN run it locally without Docker by hosting MariaDB on your machine with the login credentials specified in .env and installing Python 3.11 with the required pip packages. Note: I won't explain how to do this. Figure it out on your own.

git clone https://gitlab.com/wlinator/racu && cd racu

Copy .env.template to .env and fill out the variables.

Optional: copy users.yml.example to users.yml to properly configure Dozzle logs. Check the file for more information.

docker compose up -d --build

⚙️ Environment variables

  • TOKEN: your Discord Bot Token, you can get this here.

  • INSTANCE: this should always be "MAIN" unless you plan to run multiple bots (for testing purposes).

  • OWNER_ID: the Discord user ID of the person who will act as owner of this bot.

  • XP_GAIN_PER_MESSAGE: how much XP should be awarded to a user per message.

  • XP_GAIN_COOLDOWN: XP earning cooldown time in seconds.

  • The values with "DBX" can be ignored unless you plan to make database backups with Dropbox. In that case enter your Dropbox API credentials.

  • MARIADB_USER: the username for your MariaDB database.

  • MARIADB_PASSWORD: the password for your database.

  • MARIADB_ROOT_PASSWORD: the root password for your database. (can be ignored unless you have a specific use for it)


Some icons used in Racu are provided by Icons8.