github-ntfy

github-ntfy (ntfy_alerts) is a lightweight notifier that watches GitHub repositories and Docker Hub images for new releases and forwards release events to notification endpoints. It is implemented in Rust for performance and can run as a standalone binary or inside a Docker container.

Key Features

• Monitors GitHub releases and Docker Hub image updates and detects new releases
• Sends notifications to ntfy and Gotify, and supports Discord and Slack webhooks
• Implemented in Rust (v2 rewrite) to reduce resource usage and improve performance
• Configurable via environment variables; supports a Docker image (published image and container examples provided)
• Supports GitHub authentication via token; requires repo, read:org and read:user permissions when using authenticated queries
• Provides a CLI/binary for manual runs and supports running as a long-lived container

Use Cases

• Send automated release notifications from GitHub repositories to team channels and notification systems
• Track Docker Hub image updates and notify operators when new images are published
• Integrate release alerts into lightweight alerting pipelines or home-lab notification stacks

Limitations and Considerations

• Configuration is primarily environment-variable driven; no web-based onboarding or management UI is provided
• Notification targets are limited to the supported backends (ntfy, Gotify, Discord, Slack); additional integrations are listed as TODO
• Requires a GitHub token with specific scopes for repository and organization access when authenticated monitoring is used

github-ntfy is suited for users who need a simple, efficient bridge from release sources to notification endpoints. It favors a minimal operational footprint and predictable behavior over a full-featured management interface.