Red Discord Bot made by the Cog creators at https://github.com/Cog-Creators/Red-DiscordBot
NOTE: Server config reset is required when upgrading from v1 to v3.0 or higher.
Running Red Discord Bot data container:
docker run --name [name of your data container] jonasbonno/discordbot echo 'Data-only container'
Running Red Discord Bot container:
docker run --tty=true --interactive=true --detach=true --restart unless-stopped --name [name of your container] --volumes-from [name of your data container] --env TOKEN="[your discord bot token]" jonasbonno/discordbot
You can use this guide: https://docs.discord.red/en/stable/bot_application_guide.html?highlight=application%20page#creating-the-bot-application
--env TOKEN=[your discord bot token] - The Discord token the Red-DiscordBot will use.
--env PREFIX=! - The prefix Red-DiscordBot will use. Default set to "!" if you don't specify it.
- Grant the bot privileged intents: https://docs.discord.red/en/stable/bot_application_guide.html?highlight=Enabling%20Privileged%20Intents#enabling-privileged-intents
- Accept "Invite URL", run command to show it: docker logs [name of your container]
- Set bot permissions: https://docs.discord.red/en/stable/getting_started.html?highlight=moderator%20Administrator#administrator
The container is created with a volume exposed that is able to be mounted elsewhere containing the Red Discord Bot data folder so when running the two containers as described in the setup-section upgrading is done simply by creating a new docker container:
docker stop [name of your CURRENT container]
docker image pull jonasbonno/discordbot
docker run --tty=true --interactive=true --detach=true --restart unless-stopped --name [name of your NEW container] --volumes-from [name of your CURRENT data container] --env TOKEN="[your discord bot token]" jonasbonno/discordbot
After verifying the upgrade succeeded you can safely delete the old container with the following command: docker container rm [name of your OLD container]
Red is a fully modular bot – meaning all features and commands can be enabled/disabled to your liking, making it completely customizable. This is a self-hosted bot – meaning you will need to host and maintain your own instance. You can turn Red into an admin bot, music bot, trivia bot, new best friend or all of these together!
- Set admin role:
!set addadminrole [your discord admin group]
- Set moderator role:
!set addmodrole [your discord moderator group]
- Show loaded and unloaded cogs:
!cogs
- Load music cog:
!load music
The default set of modules includes and is not limited to:
- Moderation features (kick/ban/softban/hackban, mod-log, filter, chat cleanup)
- Trivia (lists are included and can be easily added)
- Music features (YouTube, SoundCloud, local files, playlists, queues)
- Stream alerts (Twitch, Youtube, Hitbox, Picarto)
- Bank (slot machine, user credits)
- Custom commands
- Imgur/gif search
- Admin automation (self-role assignment, cross-server announcements, mod-mail reports)
- Customisable command permissions