Unraid-Monitor-Bot
Unraid-Monitor-Bot
Docker app from dervish's Repository
Overview
Telegram bot for monitoring Docker containers and Unraid servers. Get real-time alerts, check container status, view logs, control containers,
and monitor server health - all from Telegram.
On first launch, an interactive setup wizard in Telegram guides you through connecting to your Unraid server and auto-classifies your containers into
categories (priority, protected, watched, killable, ignored). Re-run anytime with /setup.
Features:
- Interactive setup wizard with container auto-classification
- Container crash alerts with quick action buttons
- Resource monitoring (CPU/memory thresholds)
- Log watching with error detection
- AI-powered diagnostics and container classification (works with Anthropic, OpenAI, or Ollama)
- Unraid server monitoring (temps, array, disks)
- Natural language chat interface
- Smart ignore patterns for known errors
- Mute system for alerts
Setup requires a Telegram bot token from @BotFather and your Telegram user ID. After installing, message your bot with /start to begin the setup
wizard.
Runtime arguments
- Network
bridge- Shell
bash- Privileged
- false
Template configuration
Docker socket for container monitoring (read-only)
- Target
- /var/run/docker.sock
- Default
- /var/run/docker.sock
- Value
- /var/run/docker.sock
Configuration files location
- Target
- /app/config
- Default
- /mnt/user/appdata/unraidmonitorbot/config
- Value
- /mnt/user/appdata/unraidmonitorbot/config
Database and persistent data location
- Target
- /app/data
- Default
- /mnt/user/appdata/unraidmonitorbot/data
- Value
- /mnt/user/appdata/unraidmonitorbot/data
Bot token from @BotFather on Telegram
- Target
- TELEGRAM_BOT_TOKEN
Comma-separated list of Telegram user IDs allowed to use the bot (get yours from @userinfobot)
- Target
- TELEGRAM_ALLOWED_USERS
Optional: Enables AI features via Anthropic Claude models
- Target
- ANTHROPIC_API_KEY
Optional: Enables AI features via OpenAI models
- Target
- OPENAI_API_KEY
Optional: Ollama server URL for local LLM support
- Target
- OLLAMA_HOST
- Default
- http://localhost:11434
- Value
- http://localhost:11434
Optional: Override default AI model (e.g. qwen2.5:7b, gpt-4o)
- Target
- DEFAULT_MODEL
Optional: Enables Unraid server monitoring (get from Unraid Connect plugin)
- Target
- UNRAID_API_KEY
Logging verbosity (DEBUG, INFO, WARNING, ERROR)
- Target
- LOG_LEVEL
- Default
- INFO
- Value
- INFO
User ID for file ownership (99 = nobody on Unraid)
- Default
- 99
- Value
- 99
Group ID for file ownership (100 = users on Unraid)
- Default
- 100
- Value
- 100
Timezone for timestamps (e.g. America/New_York)
- Target
- TZ
- Default
- Europe/London
- Value
- Europe/London
Categories
Download Statistics
Details
dervish/unraidmonitorbot:latestRun Unraid-Monitor-Bot on Unraid.
Unraid-Monitor-Bot is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.