Skip to content

Add package installation instructions #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
martialblog merged 2 commits into from
Aug 7, 2026
Merged

Add package installation instructions #27

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f91db80
Add package installation instructions
martialblog Aug 4, 2026
429f93d
[squash]
martialblog Aug 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 34 additions & 12 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,41 @@ Other Icinga and Prometheus integrations we provide:

## Installation

The `alertmanager-icinga-bridge` is available as an executable in the GitHub Releases and as a container image `ghcr.io/netways/alertmanager-icinga-bridge`.
The `alertmanager-icinga-bridge` is available as an executable in the GitHub Releases, a container image and Linux repositories.

* Install and start the `alertmanager-icinga-bridge` executable
* Create an Icinga host and API user for Alertmanager-Icinga-Bridge
* Create an Icinga service template for the managed services
1. Install and start the `alertmanager-icinga-bridge`
2. Create an Icinga host and API user for Alertmanager-Icinga-Bridge
3. Create an Icinga service template for the managed services

### Container

A container image is available at:

```
ghcr.io/netways/alertmanager-icinga-bridge
```

### Packages

NETWAYS provides this tool via [https://packages.netways.de](https://packages.netways.de/).

To install this module, follow the setup instructions for the **extras** repository.

**RHEL or compatible:**

`dnf install netways-alertmanager-icinga-bridge`

**Ubuntu/Debian:**

`apt install netways-alertmanager-icinga-bridge`

## Usage

When started, Alertmanager-Icinga-Bridge listens to HTTP requests on the following paths:

* `/webhook` Endpoint to accept alerts from Alertmanager.
* `/healthz` returns HTTP 200 with `ok` as its payload as long as the webhook
serving loop is operational.

Example:

Expand All @@ -29,14 +59,6 @@ alertmanager-icinga-bridge \
--bearer-token alertmanager-example-token
```

## Usage

When started, Alertmanager-Icinga-Bridge listens to HTTP requests on the following paths:

* `/webhook` Endpoint to accept alerts from Alertmanager.
* `/healthz` returns HTTP 200 with `ok` as its payload as long as the webhook
serving loop is operational.

## Configuration

```
Expand Down