Repolode
Submit
release-argus

release-argus/Argus

Argus is a self-hosted monitor that polls websites for new software releases and sends notifications or webhooks when one appears.

View on GitHubWebsite
Stars
767
Forks
31
Open issues
39
Last commit
2 days ago

What is it?

Argus queries websites or APIs at a user-defined interval to check for new software releases. When a tracked version changes, it sends a notification through services such as Gotify or Slack, or calls a webhook that can trigger further automation, such as updating a server.

For example, Argus can watch a GitHub repository's releases endpoint and track the tag_name field. Each change from the previous check triggers the configured notifications or webhooks. Configuration is split into defaults, settings, service, notify and webhook sections, and the project ships as a single binary with an embedded React web UI.

Argus is written in Go with a React frontend. It includes optional login with local username/password accounts, session management, API tokens and role-based access, and it exposes Prometheus metrics. It runs as a standalone binary or a Docker image.

Key features

  • 01Polls websites or APIs at a configurable interval for new releases.
  • 02Sends notifications through Gotify, Slack and other services.
  • 03Triggers webhooks when a version changes, for use in automation.
  • 04Provides a React web UI and an API, with optional login and API tokens.
  • 05Exposes Prometheus metrics and ships as a single binary or Docker image.

Use cases

  • Getting notified when a self-hosted application publishes a new release.
  • Triggering an automated deployment or update job when a GitHub release tag changes.
  • Monitoring upstream dependencies or tools your team relies on for new versions.

Quick start

  1. 1

    Download the binary from the releases page

  2. 2

    Build from source by running make build in the repo root

    make build
  3. 3

    Set up the config file for the binary

Things to know

  • Requires Go 1.25+ and NodeJS 24 to build from source.
  • Setup beyond the binary needs a config file that you write yourself.

In collections

Self-hosted apps

Topics

#release-monitoring#notifications#webhook#self-hosted#golang#react#prometheus#go

FAQ

What is Argus?
Argus is a self-hosted monitor that polls websites for new software releases and sends notifications or webhooks when one appears. Argus queries websites or APIs at a user-defined interval to check for new software releases. When a tracked version changes, it sends a notification through services such as Gotify or Slack, or calls a webhook that can trigger further automation, such as updating a server.
Is Argus free to use? What license does it have?
Argus is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is Argus still maintained?
Actively maintained. The last commit to Argus was on Nov 5, 2026.
What can I use Argus for?
Getting notified when a self-hosted application publishes a new release. Triggering an automated deployment or update job when a GitHub release tag changes. Monitoring upstream dependencies or tools your team relies on for new versions.
How do I install Argus?
Download the binary from the releases page Build from source by running make build in the repo root: make build Set up the config file for the binary
Where can I get Argus?
The source code and installation instructions are on GitHub: https://github.com/release-argus/Argus

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

Related projects