DDC Configuration

DDC

DockerDiscordControl

Configure your DDC Bot here.

Join Demo Discord Server

See DDC in action and test it yourself!

If you find DDC helpful, consider supporting its development:

Donate with PayPal

⚡ Power the Mech with your donations to bring it to life!

-$0.00003472

OFFLINE

POWER 0

REPAIRED MECH $20 needed

Demo Server - This is a demo instance of DockerDiscordControl. Many settings are read-only or restricted. Configuration resets hourly. Visit ddc.bot for the full experience!

Discord Bot Settings

Bot Token

Channel Settings

Discord Server (Guild) ID

Status Channels

Status channels display container status messages with restricted control access.

Permissions:
• All users: Can use /serverstatus command to view container status
• Admin users: Full access to Start, Stop, Restart buttons, /task commands, Info system, and Admin Control Panel

works! →

Channel Name	Channel ID	Initial	Refresh	Minutes	Recreate	Minutes	Action
		Initial	Refresh		Recreate on Inactivity
		Initial	Refresh		Recreate on Inactivity

Control Channels

Control channels provide full container management capabilities to ALL users in the channel.

🚨 Security Warning: ALL users in control channels have unrestricted access to ALL container management functions including Start, Stop, Restart, /task commands, and Info editing. Only add trusted channels here!

Channel Name	Channel ID	Initial	Refresh	Minutes	Recreate	Minutes	Action
		Initial	Refresh		Recreate on Inactivity
		Initial	Refresh		Recreate on Inactivity

Container Selection & Bot Permissions

Select containers (check 'Active') and define the display name and allowed bot actions.

Active	Container Name / Status / Image	Status	Start	Stop	Restart
Select	`nextcloud` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`gitea` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`grafana` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`homeassistant` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`jellyfin` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`minecraft` Status: exited Image: alpine:latest	Status	Start	Stop	Restart
Select	`plex` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`satisfactory` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`uptime-kuma` Status: running Image: alpine:3.19	Status	Start	Stop	Restart
Select	`valheim` Status: exited Image: alpine:latest	Status	Start	Stop	Restart
Select	`caddy` Protected Status: running Image: caddy:alpine	Status	Start	Stop	Restart
Select	`ddc` Protected Status: running Image: ddc-demo:latest	Status	Start	Stop	Restart

Container list last updated: 2025-12-08 23:31:43 UTC

Custom IP/URL Override

Leave empty to use auto-detected public IP

Custom Port

Optional: Port number for the server

Enable Info Button

Show IP Address

Custom Info Text

/250 characters - Use line breaks for multiple entries

Protected Information

Enable Password-Protected Content

Content that requires a password to view in Discord

Schedule New Task

Define tasks to be executed on a schedule (e.g., restart a container daily).

Container

Name of the Docker container to control.

Action

Action to apply to the container.

Cycle

Task recurrence.

Time (HH:MM)

Local time in timezone

Date

For 'once', 'monthly', 'weekly' or 'yearly' tasks.

Scheduled Tasks

Manage scheduled actions for your containers.

List of tasks currently scheduled for execution.

ID	Container	Action	Cycle	Schedule Details	Next Run	Status	Active	Last Run Result	Created At	Actions
Loading... Loading tasks...

Basic Settings

Container

Action

Schedule Configuration

Cycle

Time (HH:MM)

Date

Task Status

Task is active Inactive tasks will not be executed

Auto-Action System (AAS) NEW

Automatically trigger actions based on Discord messages (e.g., game updates).

Click "Manage Auto-Actions" to configure rules.

Language and Timezone

Configure language and timezone settings for the system.

Bot Language

Language used by the bot in Discord.

Timezone

Timezone for the entire container.

Web UI Authentication

Configure the password for accessing this web interface. The username is fixed to admin.

Username

New Password (leave blank to keep current)

Note: The configuration is split into multiple files. After saving, the container should be restarted to apply changes such as token, channel IDs, or server selection!

Status Watchdog

How it works (Dead Man's Switch)

DDC periodically pings an external monitoring URL. If the ping stops, the monitoring service sends you an alert.

Create a free account at Healthchecks.io or host Uptime Kuma
Create a new "check" and copy the ping URL
Paste the URL below and set your desired interval
Configure alerts in the monitoring service (Email, Discord Webhook, etc.)

Monitoring URL

Must start with https://. Only a simple GET request is sent - no tokens or data.

Ping Interval (Minutes)

Recommended: 5 minutes. Set the monitoring service timeout to ~15 minutes.

System Logs

View and manage different log types from your DockerDiscordControl system.

Auto

Debug Level

Toggle between Debug and Info log levels. Debug shows detailed system information, Info shows standard messages.

Container Logs (last 500 lines)

Security Notice

Your Discord bot token will be displayed below. Keep this token secure and never share it publicly. Anyone with this token can control your Discord bot.

Your Current Discord Bot Token:

Click the eye icon to show/hide the token. Use the Copy button to securely copy it to your clipboard.

Migration Instructions:

Go to Docker tab → ddc container → Edit
Scroll to Variables section
Add new variable: DISCORD_BOT_TOKEN
Set value to the token copied above
Click Apply → Container restarts automatically

Create or edit .env file in your project directory
Add: DISCORD_BOT_TOKEN=your_token_here
Run: docker-compose up -d
Verify: Check logs for "Using environment variable" message

Go to Containers → ddc container → Edit
Navigate to Environment variables tab
Add variable: DISCORD_BOT_TOKEN
Set value to the token copied above
Click Update the container

Stop current container: docker stop ddc
Run with environment variable:
docker run -e DISCORD_BOT_TOKEN=your_token_here ...
Or update your existing run command with -e DISCORD_BOT_TOKEN=your_token

Auto-clear: This modal will automatically clear the token and close after 5 minutes for security.

Time remaining: 5:00

Event Sourcing Donation Management: Deleting a donation adds a compensation event and recalculates all levels and costs correctly.

Total Power

$0.00

Total Donations

0

Average Donation

$0.00

Donation History

Loading Auto-Actions...

Time	Rule	Container	Action	Result

Global Cooldown (Seconds)

Minimum time between ANY auto-action executions. Prevents spam. (Fixed at 30s on demo)

Audit Log Channel

Channel where all AAS events will be logged.

Protected Containers

Comma-separated list of containers that AAS cannot touch (case-insensitive).

1. Basic Info

Rule Name

Priority

Higher executes first

2. Trigger Conditions

Monitored Channel ID(s)

Fixed to demo channel on demo server

Allowed User IDs (Whitelist)

Only trigger if message is from these users (comma-separated)

Required Keyword(s)

Must ALL match (AND logic)

Trigger Keywords

At least one must match (OR logic)

Advanced Trigger Options

Match Mode

Ignore Keywords (Blacklist)

Regex Pattern (Python)

Only trigger on Webhook messages (e.g. Discohook)

3. Action & Execution

Action Type

Target Container(s)

Select one or more containers to apply the action to.

Delay (Seconds)

Feedback Channel(s)

Select one or more channels for action feedback.

4. Safety Settings

Cooldown (Minutes)

Prevents re-triggering on same container (Default: 24h)

Only execute if container is RUNNING

Test Match Logic (Dry Run)