discord-docker-bot/README.md

🐳 Discord Docker Monitor Bot

A Discord bot that monitors your Docker containers and displays their status in dedicated channels — updated automatically every 30 seconds.

---

✨ Features

• 📋 List all Docker containers on your host
• 📁 Create groups of containers with dedicated Discord channels
• 🔄 Automatic status updates every 30 seconds
• 🟢 Live status indicators (running, exited, paused, created)
• 🔒 Channels are read-only for regular users

---

🚀 Quick Start

1. Create your .env file

BOT_TOKEN=your_discord_bot_token
DOCKER_HOST=tcp://your-docker-host:2375
GUILD_ID=your_discord_server_id
dc_kategorie=Docker Status

2. Start with Docker Compose

services:
  discord-bot:
    image: yourusername/discord-docker-bot:latest
    restart: unless-stopped
    env_file:
      - .env

docker compose up -d

That's it! 🎉

---

🤖 Commands

Command	Description
!info	Shows all available commands
!container_list	Lists all containers on the host
!group_create <name> <container1> ...	Creates a group with a dedicated channel
!group_remove <name>	Deletes a group and its channel
!group_list	Shows all existing groups

---

📊 Status Indicators

Symbol	Status
🟢	Running
🔴	Exited
🟡	Paused
⚪	Created
❓	Unknown

---

⚙️ Requirements

• Docker & Docker Compose installed on the host
• Docker remote API enabled (tcp://host:2375)
• A Discord Bot Token (create one here)

---

🔒 Security Note

Never share your .env file — it contains sensitive tokens and credentials. The .env file is not included in the Docker image.

---

📄 License

MIT License — free to use and modify.