DDC

DockerDiscordControl Bot Setup Guide

Complete step-by-step instructions to create and configure your Discord Bot

Creating Your Discord Bot

1.Access Discord Developer Portal

Go to the Discord Developer Portal and log in with your Discord account.

2.Create a New Application

Click the "New Application" button in the top-right corner.

Enter a name for your application (e.g., "DockerControl") and click "Create".

3.Set Up Bot Profile

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).

4.Enable Required Privileged Intents

CRITICAL STEP: You MUST enable all three "Privileged Gateway Intents":

  • Presence Intent
  • Server Members Intent
  • Message Content Intent

Without these intents, your bot will fail to start with an error about missing intents.

Where to find them: In the Discord Developer Portal, go to the Bot tab. Scroll down to "Privileged Gateway Intents" section and ensure all three toggles are turned ON (they should appear blue when enabled).

5.Generate and Copy Bot Token

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.


Inviting Your Bot to Your Server

1.Create Invite URL

From the left sidebar, click on "OAuth2" then "URL Generator".

2.Select Required Scopes

Under "Scopes", check the following boxes:

  • bot
  • applications.commands

3.Select Bot Permissions

Under "Bot Permissions", select the following permissions:

  • View Channels
  • Send Messages
  • Embed Links
  • Attach Files
  • Read Message History
  • Use Slash Commands
  • Manage Messages (for editing status messages)

Alternatively, you can give the bot "Administrator" permission, but this is generally not recommended for security reasons.

4.Add Bot to Your Server

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.

Important Note About Slash Commands

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.


Getting Your Server (Guild) ID

1.Enable Developer Mode in Discord

Open Discord and go to User Settings (the gear icon near your username).

Navigate to "Advanced" and enable "Developer Mode".

2.Copy Server ID

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.


Configuring DDC with Bot Details

1.Enter Bot Token

Access your DockerDiscordControl configuration page (usually at http://your-server:8374).

Paste your Bot Token into the "Bot Token" field.

2.Enter Guild ID

Paste your Server (Guild) ID into the "Guild ID" field.

3.Configure Channel Permissions

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.

4.Save Changes

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

Need Help?

If you encounter any issues during the setup process, check out these resources:

Built by MAX