{"id":21502939,"url":"https://github.com/pyenb/watchtower-telegram-notifications","last_synced_at":"2025-10-10T21:15:14.891Z","repository":{"id":192459410,"uuid":"686763862","full_name":"Pyenb/Watchtower-telegram-notifications","owner":"Pyenb","description":"A simple write-up on how to receive Telegram notifications from Watchtower whenever an image is updated.","archived":false,"fork":false,"pushed_at":"2024-04-11T13:39:05.000Z","size":20,"stargazers_count":26,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-10-10T21:15:12.120Z","etag":null,"topics":["docker","docker-compose","notifications","telegram","telegram-bot","watchtower","watchtower-container","watchtowerrr"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pyenb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"Pyenb","ko_fi":"Pyenb"}},"created_at":"2023-09-03T21:27:22.000Z","updated_at":"2025-09-23T10:37:02.000Z","dependencies_parsed_at":"2024-01-08T00:33:15.641Z","dependency_job_id":"f159ded2-a3af-4fd6-8ce0-4285c1ff0639","html_url":"https://github.com/Pyenb/Watchtower-telegram-notifications","commit_stats":null,"previous_names":["pyenb/watchtower-telegram-notifications"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Pyenb/Watchtower-telegram-notifications","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pyenb%2FWatchtower-telegram-notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pyenb%2FWatchtower-telegram-notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pyenb%2FWatchtower-telegram-notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pyenb%2FWatchtower-telegram-notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pyenb","download_url":"https://codeload.github.com/Pyenb/Watchtower-telegram-notifications/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pyenb%2FWatchtower-telegram-notifications/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005412,"owners_count":26083883,"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","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["docker","docker-compose","notifications","telegram","telegram-bot","watchtower","watchtower-container","watchtowerrr"],"created_at":"2024-11-23T18:18:40.105Z","updated_at":"2025-10-10T21:15:14.857Z","avatar_url":"https://github.com/Pyenb.png","language":null,"funding_links":["https://github.com/sponsors/Pyenb","https://ko-fi.com/Pyenb"],"categories":[],"sub_categories":[],"readme":"# Watchtower telegram notifications\n\nThis repo is just a simple write-up on how to get telegram notifications from Watchtower, when a container is updated. This version is mostly focused on docker-compose, but should also work with docker run.\n\n## Contents\n\n1. [Installation](#installation)\n2. [Complete docker-compose file](#complete-docker-compose-file)\n3. [Contributing](#contributing)\n4. [Disclaimer](#disclaimer)\n\n## Installation\n\nIt's pretty easy to get telegram notifications from Watchtower. You just need to follow these steps:\n\n### 1. Telegram Bot\n\nFirstly, we need to create a new telegram bot. For that open a new chat with [BotFather](https://telegram.me/botfather), type in the command `/newbot` and follow the instructions. In the end you should see a message like this:\n\n![success](https://i.imgur.com/ugOzB1B.png)\n\n### 2. Get your chat id\n\nAfter creating your bot, you need to get your chat id. For that, open a new chat with your bot, start it and tag `@get_id_bot` in the chat. You should get a message like this:\n\n![chat id](https://i.ibb.co/0GY3cFp/Bild-2023-09-03-230007186.png)\n\n### 3. Setup Watchtower\n\nNow we need to setup Watchtower. For that, you need to add the following environment variables to your docker-compose file:\n\n```yaml\nenvironment:\n    - WATCHTOWER_NOTIFICATIONS=shoutrrr\n    - WATCHTOWER_NOTIFICATION_URL=telegram://HTTP_API_TOKEN@telegram?chats=CHAT_ID\n```\n\nReplace `HTTP_API_TOKEN` with the token you got from BotFather in step 1. and `CHAT_ID` with the chat id you got from `@get_id_bot` in step 2.\n\n### 4. (Re)start Watchtower\n\nNow you can (re)start Watchtower:\n\n```bash\nsudo docker-compose up -d --force-recreate\n```\n\nand you should get a message from your bot, that Watchtower is running. The message should look like this:\n\n![watchtower running](https://i.ibb.co/wB2T6vK/Bild-2023-09-03-230440535.png)\n\nYou will also get a message, when a container is updated. It should look like this:\n\n![updated](https://i.ibb.co/QkD8ywr/Bild-2023-09-03-231219112.png)\n\n## Complete docker-compose file\n\nIf you are still unsure, how your docker-compose file should look like, check out the `docker-compose.yml` file in this repo. Most optional settings are commented, so everything is more understandable. Just remember to replace `HTTP_API_TOKEN` with the token you got from BotFather in step 1. and `CHAT_ID` with the chat id you got from `@get_id_bot` in step 2.\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n\n## Disclaimer\nThis repository is for research purposes only, the use of this code is your responsibility.\n\nI take NO responsibility and/or liability for how you choose to use any of the source code available here. By using any of the files available in this repository, you understand that you are AGREEING TO USE AT YOUR OWN RISK. Once again, ALL files available here are for EDUCATION and/or RESEARCH purposes ONLY.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyenb%2Fwatchtower-telegram-notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpyenb%2Fwatchtower-telegram-notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpyenb%2Fwatchtower-telegram-notifications/lists"}