Repolode
Submit
iamspido

iamspido/github-release-monitor

Self-hosted app that monitors GitHub, GitLab, Codeberg and Forgejo releases and sends email or Apprise notifications.

View on GitHub
Stars
445
Forks
15
Open issues
12
Last commit
10 hours ago

What is it?

GitHub Release Monitor is a self-hostable web app that watches public repositories on GitHub, GitLab, Codeberg and self-hosted Forgejo instances for new releases. Instead of checking project pages by hand, you add the repositories you care about and the app polls them in the background.

When a new release is detected, it can notify you by SMTP email or through Apprise, which covers dozens of chat and push services such as Telegram, Discord and Slack. Global and per-repository filters control which release types count, and include or exclude regular expressions let you narrow matches to specific tags. Notifications can be sent per release or grouped into digests per channel.

The app is built with Next.js, Tailwind CSS and ShadCN UI, and uses Better Auth for login with SQLite storage, passkeys and optional GitHub or Google sign-in. It is deployable via Docker Compose, Docker run, or a manual Node.js setup, and includes JSON import and export of the monitored list.

Key features

  • 01Monitors public GitHub, GitLab, Codeberg and self-hosted Forgejo repositories for new releases.
  • 02Sends notifications by SMTP email or through Apprise to many chat and push services.
  • 03Global and per-repository filters for stable, pre-release and draft releases.
  • 04Regex include and exclude patterns for fine-grained tag matching.
  • 05Import and export of the monitored repository list as JSON.
  • 06Login with Better Auth, passkeys and optional GitHub or Google sign-in.

Use cases

  • Tracking updates to self-hosted tools you run without watching each project's releases page.
  • Getting Telegram or Discord alerts when dependencies you rely on publish a new version.
  • Following pre-release channels such as beta or rc builds for selected projects.
  • Monitoring private GitLab or Forgejo repositories on an internal server with access tokens.

Quick start

  1. 1

    Go to the example/ directory of the repository

  2. 2

    Edit the .env files and compose.yaml for your domain, authentication, and mail settings as described in the README

Things to know

  • Licensed under AGPL-3.0-only, a copyleft license that requires sharing modified source when offered as a network service.
  • The documented setup is Docker Compose on your own server with a domain name, so self-hosting takes some effort.
  • The license metadata reads NOASSERTION, though the README states AGPL-3.0-only.

In collections

Self-hosted appsLogin, SSO & identity servers

Topics

#release-monitoring#notifications#github#gitlab#self-hosted#nextjs#docker#email#2fa#apprise

FAQ

What is github-release-monitor?
Self-hosted app that monitors GitHub, GitLab, Codeberg and Forgejo releases and sends email or Apprise notifications. GitHub Release Monitor is a self-hostable web app that watches public repositories on GitHub, GitLab, Codeberg and self-hosted Forgejo instances for new releases. Instead of checking project pages by hand, you add the repositories you care about and the app polls them in the background.
Is github-release-monitor free to use? What license does it have?
github-release-monitor is open source under the Other license. Check the license terms before using it in commercial products.
Is github-release-monitor still maintained?
Actively maintained. The last commit to github-release-monitor was on Nov 7, 2026.
What can I use github-release-monitor for?
Tracking updates to self-hosted tools you run without watching each project's releases page. Getting Telegram or Discord alerts when dependencies you rely on publish a new version. Following pre-release channels such as beta or rc builds for selected projects. Monitoring private GitLab or Forgejo repositories on an internal server with access tokens.
How do I install github-release-monitor?
Go to the example/ directory of the repository Edit the .env files and compose.yaml for your domain, authentication, and mail settings as described in the README
Where can I get github-release-monitor?
The source code and installation instructions are on GitHub: https://github.com/iamspido/github-release-monitor

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects