Lucas Berger
7e85697899
All 4 API requirements verified successfully: - API-01: Authentication works (200 response from /api/v1/workflows) - API-02: Can read workflow (Docker Manager Bot - 96 nodes) - API-03: Can update workflow (PUT successful, updatedAt: 2026-02-03T13:15:35.015Z) - API-04: Can view execution history (5 recent executions retrieved) Created .env.n8n-api with N8N_HOST and N8N_API_KEY (gitignored) Created .gitignore to protect API credentials Workflow ID: HmiXBlJefBRPMS0m4iNYc n8n Instance: https://api.bergerhouse.net
Docker Manager Bot
Telegram bot for managing Docker containers on Unraid. Control containers from your phone with simple keyword commands.
Prerequisites
- Unraid server with Docker enabled
- n8n container running on Unraid
- Telegram Bot Token (from @BotFather)
- Your Telegram User ID (from @userinfobot)
Installation
1. Configure n8n Container
Your n8n container needs Docker socket access to manage other containers. Add these flags to your n8n container configuration:
docker run -d \
--name n8n \
--group-add 281 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /path/to/curl:/usr/bin/curl:ro \
-p 5678:5678 \
n8nio/n8n
Required flags:
--group-add 281- Adds Docker group (GID 281 on Unraid) so n8n can access the Docker socket-v /var/run/docker.sock:/var/run/docker.sock- Mounts the Docker socket for container management-v /path/to/curl:/usr/bin/curl:ro- Mounts a static curl binary (hardened n8n image lacks package manager)
If using Unraid's Community Applications, add these to the "Extra Parameters" and "Path" sections of your n8n container template.
2. Create Telegram API Credential
In the n8n web interface:
- Go to Settings > Credentials > Add Credential
- Search for "Telegram API"
- Name:
Telegram API - Access Token: paste your bot token from @BotFather
3. Import Workflow
- Download
n8n-workflow.jsonfrom this repository - In n8n: Workflows > Import from File
- Select
n8n-workflow.json - When prompted, map the
Telegram APIcredential
4. Configure Your User ID
The workflow only responds to your Telegram user ID. To set it:
- Open the imported workflow
- Find the IF User Authenticated node
- Click to edit, find the condition with
rightValue - Change
563878771to your Telegram user ID - Repeat for IF Callback Authenticated node
- Save the workflow
5. Activate Workflow
- Click the "Active" toggle in the top-right corner
- Test by sending "status" to your bot in Telegram
Usage
Send commands via Telegram or use the persistent menu buttons:
| Command | Description |
|---|---|
status |
View all containers with status indicators |
start <name> |
Start a stopped container |
stop <name> |
Stop a running container |
restart <name> |
Restart a container |
update <name> |
Pull latest image and recreate container |
logs <name> [lines] |
View container logs (default: 50 lines) |
Container names support partial matching. For example, start plex will match linuxserver-plex.
Menu Buttons
Send /start or any unrecognized text to display the persistent keyboard with quick-access buttons for all commands.
Security
The bot only responds to the Telegram user ID configured in the IF nodes. Messages from other users are silently ignored.
License
MIT