{"id":28919673,"url":"https://github.com/andvarfolomeev/docker-notifier","last_synced_at":"2026-05-06T19:05:53.467Z","repository":{"id":299465226,"uuid":"1001120238","full_name":"andvarfolomeev/docker-notifier","owner":"andvarfolomeev","description":"WIP: Lightweight error notifier for your containers written in Go","archived":false,"fork":false,"pushed_at":"2025-06-16T17:35:17.000Z","size":49,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-16T18:37:05.537Z","etag":null,"topics":["alert-bot","alerts","docker","docker-compose","docker-image","logging","telegram","telegram-bot","telegram-bot-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andvarfolomeev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-12T21:19:34.000Z","updated_at":"2025-06-16T17:38:32.000Z","dependencies_parsed_at":"2025-06-16T18:49:47.684Z","dependency_job_id":null,"html_url":"https://github.com/andvarfolomeev/docker-notifier","commit_stats":null,"previous_names":["andvarfolomeev/docker-notifier"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/andvarfolomeev/docker-notifier","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andvarfolomeev%2Fdocker-notifier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andvarfolomeev%2Fdocker-notifier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andvarfolomeev%2Fdocker-notifier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andvarfolomeev%2Fdocker-notifier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andvarfolomeev","download_url":"https://codeload.github.com/andvarfolomeev/docker-notifier/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andvarfolomeev%2Fdocker-notifier/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261233072,"owners_count":23128191,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alert-bot","alerts","docker","docker-compose","docker-image","logging","telegram","telegram-bot","telegram-bot-api"],"created_at":"2025-06-22T04:00:30.068Z","updated_at":"2026-05-06T19:05:53.462Z","avatar_url":"https://github.com/andvarfolomeev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Notifier 🐳\n\nMonitor Docker container logs and get instant Telegram notifications when errors occur.\n\n## Overview\n\nDocker Notifier watches your container logs for error patterns and sends notifications to Telegram when matches are found. Easily integrate with your existing Docker setup to get alerts about errors in real-time.\n\n## Features\n\n- 🔍 Monitor container logs for custom error patterns\n- 🏷️ Filter containers by labels\n- 📱 Send notifications to Telegram\n- ⏱️ Configurable polling interval\n- 🛠️ Simple integration with docker-compose\n\n## Quick Start\n\n### Using docker-compose\n\n```yaml\nversion: \"3\"\n\nservices:\n  docker-notifier:\n    image: ghcr.io/andvarfolomeev/docker-notifier:main\n    volumes:\n      - /var/run/docker.sock:/var/run/docker.sock\n    restart: unless-stopped\n    environment:\n      - TELEGRAM_TOKEN=your_telegram_bot_token\n      - TELEGRAM_CHAT_ID=your_telegram_chat_id\n    command: \u003e\n      /app/docker-notifier\n        --interval 5\n        --label-enable\n        --telegram-token \"${TELEGRAM_TOKEN}\"\n        --telegram-chat-id \"${TELEGRAM_CHAT_ID}\"\n        --error-pattern \"ERROR\"\n        --error-pattern \"FATAL\"\n        --error-pattern \"Exception\"\n\n  # Example service to monitor\n  example-service:\n    image: alpine:latest\n    labels:\n      - \"com.andvarfolomeev.dockernotifier.enable=true\"\n    command: \u003e\n      sh -c \"while true; do echo 'Normal log line'; sleep 5; echo 'ERROR: This is an error message'; sleep 10; done\"\n```\n\n### Using Docker run\n\n```bash\ndocker run -d \\\n  --name docker-notifier \\\n  -v /var/run/docker.sock:/var/run/docker.sock \\\n  ghcr.io/andvarfolomeev/docker-notifier:main \\\n  /app/docker-notifier \\\n    --telegram-token \"your_telegram_bot_token\" \\\n    --telegram-chat-id \"your_telegram_chat_id\" \\\n    --error-pattern \"ERROR\" \\\n    --error-pattern \"FATAL\"\n```\n\n## Configuration\n\n### Command-line Arguments\n\n| Argument | Description | Default |\n|----------|-------------|---------|\n| `--interval` | Log polling interval in seconds | 5 |\n| `--label-enable` | Enable label filter (only monitor containers with the label) | false |\n| `--telegram-token` | Telegram Bot API token (required) | - |\n| `--telegram-chat-id` | Target Telegram chat ID (required) | - |\n| `--error-pattern` | Regex pattern for matching error lines (can be used multiple times) | \"ERROR\" |\n| `--debug` | Enable debug logging | false |\n| `--help` | Display help information | - |\n\n### Container Labels\n\nWhen `--label-enable` is set, Docker Notifier will only monitor containers with this label:\n\n```\ncom.andvarfolomeev.dockernotifier.enable=true\n```\n\n## Setup Telegram Bot\n\n1. Create a new bot via [@BotFather](https://t.me/botfather) on Telegram\n2. Get your bot token\n3. Start a conversation with your bot\n4. Get your chat ID (using [@userinfobot](https://t.me/userinfobot) or other methods)\n5. Use these values for `--telegram-token` and `--telegram-chat-id`\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandvarfolomeev%2Fdocker-notifier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandvarfolomeev%2Fdocker-notifier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandvarfolomeev%2Fdocker-notifier/lists"}