GitHub - sammy8806/foghorn: Notification Agent for Alertmanager. Especially nice with macos · GitHub
Skip to content
sammy8806Public

About

Notification Agent for Alertmanager. Especially nice with macos

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

260 Commits

Folders and files

Repository files navigation

Foghorn

Foghorn

Your alerts, together on your desktop. macOS, Linux, and Windows.

Foghorn brings Alertmanager, Grafana Alerting, Prometheus, and Better Stack into one desktop app. See what is firing across your sources, get native notifications, and manage silences without switching between dashboards.

Foghorn showing grouped alerts, expanded alert details, a silenced alert, and the current on-call engineer

Native macOS window with synthetic demo alerts. Source names, infrastructure details, and the on-call person are fictional.

Download and install

Download the package for your platform from the latest release. No Go or Node.js installation is needed to run a release build.

Platform Package Installation
macOS, Apple Silicon and Intel Universal .dmg Open the disk image and drag Foghorn into Applications.
Linux, x86_64 .AppImage Install the runtime packages below, make the file executable, and run it.
Windows, x64 -amd64-installer.exe Run the installer. It also installs WebView2 if needed.

Then add your alert sources using the configuration guide. Allow desktop notifications when prompted. On macOS and Windows, closing the window keeps Foghorn in the tray; use its tray menu to quit.

Linux release builds use your system's GTK/WebKitGTK libraries. Install them before opening the AppImage:

# Fedora
sudo dnf install webkit2gtk4.1 gtk3 libayatana-appindicator-gtk3

# Ubuntu 24.04 / Kubuntu
sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 libayatana-appindicator3-1

# Replace the version with the release you downloaded.
chmod +x "foghorn-<version>-x86_64.AppImage"
./"foghorn-<version>-x86_64.AppImage"

KDE also needs these GTK libraries. GNOME needs AppIndicator support to show a tray icon; Foghorn remains usable as a regular window when the tray is unavailable.

Features

  • Connect multiple instances of Alertmanager, Grafana Alerting, Prometheus, and Better Stack. Sources poll independently, so a slow source does not block the others.
  • View, create, edit, and expire silences on sources that support them. Build silence matchers from an alert or a search query.
  • Search with free text, negation, exact label matches, and regular expressions. Filter by severity or source, and choose grouping and sorting presets.
  • Show the current Better Stack on-call engineer and follow links to incidents.
  • Receive native desktop notifications and monitor alert state from the system tray.
  • Configure severity aliases, visible labels and annotations, grouping, sorting, hide rules, and popup placement in YAML. Configuration reloads on save.
  • Connect through basic, bearer, cookie, or OIDC device authentication where supported. Persist OIDC logins in macOS Keychain, Linux Secret Service, or Windows Credential Manager.
  • Diagnose source failures, configuration errors, and notification permissions directly in the app. Adjust text or interface scaling for readability.

See the search guide, sorting guide, and OIDC setup guide for details.

Configuration and first run

Foghorn reads config.yaml from the following location. After starting the app for the first time, edit this file to connect your alert sources:

Platform Configuration file
macOS ~/Library/Application Support/foghorn/config.yaml
Linux ~/.config/foghorn/config.yaml, or $XDG_CONFIG_HOME/foghorn/config.yaml
Windows %APPDATA%\\foghorn\\config.yaml

If the file is missing, copy config.example.yaml to that location first. The current app falls back to in-memory defaults and does not automatically install the example. Existing configurations from the legacy location are migrated when applicable.

Set your source URLs and authentication, then save. Foghorn reloads configuration on save and reports configuration or connection problems in the app.

Configuration guide and provider examples

Documentation

License

TBD.

About

Notification Agent for Alertmanager. Especially nice with macos

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages