Complete step-by-step instructions to create and configure your Discord Bot
This guide will help you set up the Discord Bot portion of DockerDiscordControl. You'll need:
After completing this guide, you'll need to save the Bot Token and Server (Guild) ID in your DDC configuration.
Learn more at https://ddc.bot
Go to the Discord Developer Portal and log in with your Discord account.
Click the "New Application" button in the top-right corner.
Enter a name for your application (e.g., "DockerControl") and click "Create".
From the left sidebar, click on the "Bot" tab.
Here you can customize your bot's username and avatar if desired.
Toggle "Public Bot" ON if you want others to be able to invite your bot (recommended OFF for private use).
CRITICAL STEP: You MUST enable all three "Privileged Gateway Intents":
Without these intents, your bot will fail to start with an error about missing intents.
In the Bot tab, click "Reset Token" to generate a new token, then click "Copy" to copy it.
SECURITY WARNING: This token gives complete access to your bot. Never share it publicly or commit it to version control.
Store this token safely - you'll need to paste it into the DDC configuration later.
From the left sidebar, click on "OAuth2" then "URL Generator".
Under "Scopes", check the following boxes:
Under "Bot Permissions", select the following permissions:
Alternatively, you can give the bot "Administrator" permission, but this is generally not recommended for security reasons.
Copy the generated URL at the bottom of the page.
Paste the URL into your browser's address bar and press Enter.
Select the server where you want to add the bot, then click "Authorize".
Complete the CAPTCHA verification if prompted.
After adding your bot to the server, slash commands may not be immediately available. Discord can take up to one hour to fully register all commands across their network. If commands don't appear right away, please be patient.
Open Discord and go to User Settings (the gear icon near your username).
Navigate to "Advanced" and enable "Developer Mode".
Right-click on your server's icon in the server list.
Select "Copy ID" from the context menu.
This is your Server (Guild) ID that you'll need for DDC configuration.
Access your DockerDiscordControl configuration page (usually at http://your-server:8374
).
Paste your Bot Token into the "Bot Token" field.
Paste your Server (Guild) ID into the "Guild ID" field.
Set up channel permissions to determine which Discord channels can be used for control and status messages.
For each channel, you'll need to add its ID and configure appropriate permissions.
Click "Save Configuration" to apply your changes.
Restart the Docker container for the changes to take effect.
For additional help and resources, visit https://ddc.bot
If you encounter any issues during the setup process, check out these resources: