{"id":17684636,"url":"https://github.com/tarampampam/rssbot-docker","last_synced_at":"2025-10-14T07:31:49.648Z","repository":{"id":56130216,"uuid":"523285280","full_name":"tarampampam/rssbot-docker","owner":"tarampampam","description":"🤖 Docker image with lightweight Telegram RSS notification bot","archived":false,"fork":false,"pushed_at":"2025-03-14T10:02:34.000Z","size":90,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-05T20:15:04.337Z","etag":null,"topics":["docker","rss","telegram-bot","telegram-rss","telegram-rss-bot"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tarampampam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2022-08-10T09:43:29.000Z","updated_at":"2025-03-14T10:02:38.000Z","dependencies_parsed_at":"2023-10-01T16:14:23.458Z","dependency_job_id":"cd7c7326-c06c-4f11-a80d-a66065c390aa","html_url":"https://github.com/tarampampam/rssbot-docker","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frssbot-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frssbot-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frssbot-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tarampampam%2Frssbot-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tarampampam","download_url":"https://codeload.github.com/tarampampam/rssbot-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253829829,"owners_count":21970988,"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":["docker","rss","telegram-bot","telegram-rss","telegram-rss-bot"],"created_at":"2024-10-24T10:24:21.941Z","updated_at":"2025-10-14T07:31:44.611Z","avatar_url":"https://github.com/tarampampam.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://socialify.git.ci/tarampampam/rssbot-docker/image?forks=1\u0026issues=1\u0026owner=1\u0026stargazers=1\u0026theme=Dark\" alt=\"\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/tarampampam/rssbot-docker/tests.yml?branch=master\u0026maxAge=30\u0026label=tests\u0026logo=github\u0026style=flat-square\" alt=\"\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/tarampampam/rssbot-docker/release.yml?maxAge=30\u0026label=release\u0026logo=github\u0026style=flat-square\" alt=\"\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/tarampampam/rssbot-docker.svg?maxAge=30\u0026style=flat-square\" alt=\"\" /\u003e\n\u003c/p\u003e\n\n## What includes this image?\n\nDocker image with [rssbot][rssbot]. Documentation can be found [here][rssbot]. Quick usage help:\n\n```shell\nUSAGE:\n    rssbot [FLAGS] [OPTIONS] \u003ctoken\u003e\n\nFLAGS:\n    -h, --help          Prints help information\n        --insecure      DANGER: Insecure mode, accept invalid TLS certificates\n        --restricted    Make bot commands only accessible for group admins\n    -V, --version       Prints version information\n\nOPTIONS:\n        --admin \u003cuser id\u003e...        Private mode, only specified user can use this bot. This argument can be passed\n                                    multiple times to allow multiple admins\n        --api-uri \u003ctgapi-uri\u003e       Custom telegram api URI [default: https://api.telegram.org/]\n    -d, --database \u003cpath\u003e           Path to database [default: ./rssbot.json]\n        --max-feed-size \u003cbytes\u003e     Maximum feed size, 0 is unlimited [default: 2097152]\n        --max-interval \u003cseconds\u003e    Maximum fetch interval [default: 43200]\n        --min-interval \u003cseconds\u003e    Minimum fetch interval [default: 300]\n\nARGS:\n    \u003ctoken\u003e    Telegram bot token\n```\n\n\u003e Note: You can get `\u003cuser id\u003e` using bots like @userinfobot @getidsbot\n\n## Docker image\n\n| Registry                          | Image                        |\n|-----------------------------------|------------------------------|\n| [GitHub Container Registry][ghcr] | `ghcr.io/tarampampam/rssbot` |\n\nAll supported image tags (app versions) [can be found here](https://github.com/tarampampam/rssbot-docker/pkgs/container/rssbot/versions).\n\nFollowing platforms for this image are available:\n\n```shell\n$ docker run --rm mplatform/mquery ghcr.io/tarampampam/rssbot:latest\nImage: ghcr.io/tarampampam/rssbot:latest\n * Manifest List: Yes\n * Supported platforms:\n   - linux/amd64\n   - linux/arm64\n```\n\n\u003e [!IMPORTANT]\n\u003e It’s recommended to avoid using the `latest` tag, as **major** upgrades may include breaking changes.\n\u003e Instead, use specific tags in `X.Y.Z` format for version consistency.\n\n\u003e [!WARNING]\n\u003e The versioning of the application inside the image and the Docker image itself are not the same. Therefore, the\n\u003e previously published image tags listed below are **not recommended** for use:\n\u003e\n\u003e - `2.0.0-alpha-13-en`\n\u003e - `2.0.0-alpha-13-zn`\n\u003e - `2.0.0-alpha-12-en`\n\u003e - `2.0.0-alpha-12-zn`\n\u003e - `2.0.0-alpha-11-en`\n\u003e - `2.0.0-alpha-11-zn`\n\u003e\n\u003e Instead, I have adopted a new versioning system, starting from `1.0.0` and `1.0.0-zh` (for the Chinese version),\n\u003e and will continue using this format moving forward. The `X.Y.Z` (and `X.Y.Z-en`) tags will always correspond to\n\u003e the English version, while `X.Y.Z-zh` will indicate the Chinese version. The pattern is as follows:\n\u003e\n\u003e | Docker Image Tag                    | Version Description | Language |\n\u003e |-------------------------------------|---------------------|----------|\n\u003e | `latest`                            | Latest              | English  |\n\u003e | `X`, `X-en`                         | Major               | English  |\n\u003e | `X-zh`                              | Major               | Chinese  |\n\u003e | `X.Y`, `X.Y-en`                     | Minor               | English  |\n\u003e | `X.Y-zh`                            | Minor               | Chinese  |\n\u003e | `X.Y.Z[-build]`, `X.Y.Z[-build]-en` | Patch               | English  |\n\u003e | `X.Y.Z[-build]-zh`                  | Patch               | Chinese  |\n\u003e\n\u003e When a new version such as `1.2.3` is released, the `latest` tag will be updated to point to the new version,\n\u003e along with the `1`, `1-en`, `1.2`, `1.2-en`, `1.2.3`, and `1.2.3-en` tags. Similarly, the `1-zh`, `1.2-zh`,\n\u003e and `1.2.3-zh` tags will be updated accordingly.\n\n### Kubernetes\n\nTo install it on Kubernetes (K8s), please use the Helm chart from [ArtifactHUB][artifact-hub].\n\n[artifact-hub]:https://artifacthub.io/packages/helm/rssbot/rssbot\n\n### Usage examples\n\n```shell\n$ docker run --rm -v \"$(pwd):/rootfs:rw\" \\\n    ghcr.io/tarampampam/rssbot:1-en \\\n      --database /rootfs/rssbot.json \\\n      \u003ctelegram-bot-token\u003e\n```\n\nOr you can use a `docker-compose`:\n\n```yaml\nvolumes:\n  rssbot-data: {}\n\nservices:\n  rssbot:\n    image: ghcr.io/tarampampam/rssbot:1-en\n    volumes: [rssbot-data:/data:rw]\n    command: ['--database', '/data/rssbot.json', '\u003ctelegram-bot-token\u003e']\n```\n\n## Releasing\n\nNew versions publishing is very simple - just \"publish\" new release using repo releases page. Release version should\nbe same as the rssbot version.\n\n## License\n\nWTFPL. Use anywhere for your pleasure.\n\n[rssbot]:https://github.com/iovxw/rssbot\n[ghcr]:https://github.com/tarampampam/rssbot-docker/pkgs/container/rssbot\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarampampam%2Frssbot-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftarampampam%2Frssbot-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftarampampam%2Frssbot-docker/lists"}