# Argus

Argus is a lightweight monitor to notify of new software releases via Gotify/Slack/other messages and/or WebHooks. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/3765/argus

## Description

Argus is a lightweight monitor to notify of new software releases via Gotify/Slack/other messages and/or WebHooks.

## Platform availability

Available on 3 of 10 platforms: Proxmox, Helm, Any server.

## Health score

77/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 5 days ago)
- Popular: 58 (785 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Security check: 88 (no serious findings, 2 minor, CI, tests)

## Links

- Official website: https://release-argus.io/
- GitHub: https://github.com/release-argus/Argus
- Documentation: https://release-argus.io/docs/
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=argus

## Common questions

### How can Argus monitor a private GitHub repository?

Provide an Access Token with access to the private repository.

### How do I monitor a software release that is not on GitHub?

Provide the website URL and a regex for the latest version.

### How do I create the first Argus admin or reset a password?

Use -auth.create-admin before any account exists to create an admin and print a generated password. Use -auth.reset-password to reset a named user's password; their sessions are revoked but API tokens remain unchanged.

### Where does Argus keep its data and configuration file?

It uses data/argus.db for the database by default, changeable with -data.database-file or ARGUS_DATA_DATABASE_FILE. It reads config.yml by default, changeable with -config.file or ARGUS_CONFIG_FILE.

### How can I test a monitor or notification target during setup?

Use -test.service to test a version query, -test.commands to test service commands, and -test.notify to send a test message from a named notification service.

---
Source: Our Local Host (https://ourlocalhost.com/app/3765/argus), the self-hosted and open-source app directory.
