Rackabecix is a simple Discord bot built with Discord.js. It offers features such as a quoting system, birthday reminders and live subreddit feeds.
This section provides a guide for deploying the bot using Docker Compose. The bot consists of two services: the main Rackabecix bot and the Watchtower service for automatically updating the bot's Docker image.
Before deploying the Rackabecix bot, ensure you meet the following prerequisites:
- Docker and Docker Compose (latest versions)
- Bot Application in Discord's Developer Portal: You must have a bot application set up in the Discord Developer Portal. This is where you'll obtain the
TOKENandCLIENT_IDneeded for the bot's configuration.- Make sure to give your bot the necessary permissions such as
botandapplication.commandsfor its intended functionality.
- Make sure to give your bot the necessary permissions such as
-
Copy the docker-compose.yml file: Navigate to the
deploymentdirectory and copy thedocker-compose.ymlfile on your local machine. -
Configure Environment Variables: Edit the
docker-compose.ymlfile to include your bot'sTOKENandCLIENT_ID. Replace<TOKEN>and<CLIENT_ID>with your bot's token and client ID, respectively.-
The
DEPLOY_COMMANDSenvironnement variable is optional and set totrueby default. It enables the deployment of global commands. -
The
FORCE_INITIALIZE_DATABASEvariable is also optional and set tofalseby default. It force the initialization of the database on startup creating a fresh database and resetting the existing one.
-
-
Start the Services: Use the command
docker-compose up -dto start both the Rackabecix bot and Watchtower services. The bot service is configured to restart automatically and will persist across reboots with a mounted volumes for database storage.
To stop the services, you can run the command docker-compose down from the same directory.
If you need to update the bot's configuration, simply edit the docker-compose.yml file and restart the services using docker-compose down followed by docker-compose up -d.
TODO