
managebot
Python-based Discord bot that lets authorized users list and control Docker containers and images via Discord commands, using the host Docker socket.
managebot is a lightweight Discord bot that exposes Docker container and image management via Discord slash commands. It runs as a Python service and talks to the host Docker daemon (via the Docker socket) to list containers, run lifecycle commands, and manage images.
Key Features
- Execute container lifecycle commands (start, stop, restart, pause, unpause, delete) from Discord
- List containers with Online/Offline grouping and show basic container metadata
- Manage Docker images and run image pruning operations
- Uptime command and simple status configuration for bot presence
- Permission control via configured guild IDs and allowed admin user IDs
- Designed to run in a container with the host Docker socket mounted for direct Docker API access
Use Cases
- Allow a small operations or homelab team to control Docker services from Discord
- Quick remote troubleshooting and restarts of containers without SSH access
- Lightweight automation for container housekeeping and image pruning via chat commands
Limitations and Considerations
- Requires mounting the host Docker socket into the bot container, which grants broad control over the host and is a security risk
- Access control is based on configured guild IDs and a list of allowed user IDs; there is no fine-grained RBAC or audit trail built in
- No dedicated web UI; interaction is limited to Discord commands and responses
managebot is suitable for homelabs and small teams that need simple chat-driven container control. It is pragmatic and focused on core container operations rather than advanced orchestration or multi-user access policies.
