Home

release-notifier Wiki

Welcome to the release-notifier wiki. This tool watches GitHub releases for your self-hosted Docker stack, summarises changelogs with AI, and pushes notifications to your phone via ntfy and/or Home Assistant.

Navigation

Page	Description
Installation	Step-by-step setup guide
Configuration	All environment variables and containers.yml options
AI Providers	Claude, OpenAI, and Ollama setup and comparison
Notification Providers	ntfy and Home Assistant setup
API Reference	All endpoints with request and response examples
Troubleshooting	Common issues and how to fix them
Contributing	How to contribute to the project

Quick links

• Docker Hub
• GitHub Repository
• Report an issue

At a glance

GitHub releases → AI summary → ntfy / Home Assistant → your phone

release-notifier runs as a lightweight Docker container on your NAS or homelab server. It checks GitHub every 6 hours (configurable), generates a structured summary using your chosen AI provider, classifies urgency, and sends a push notification with the summary to your phone.

Supported AI providers: Claude (Anthropic), OpenAI (gpt-4o-mini / gpt-4o), Ollama (local, free)

Supported notification providers: ntfy, Home Assistant, or both simultaneously