ICINGA-TUI(1)marcp.xyzICINGA-TUI(1)

NAME

icinga-tui - Terminal dashboard for Icinga2 monitoring

SYNOPSIS

curl -LO https://marcp.xyz/scripts/icinga-tui
chmod +x icinga-tui
./icinga-tui -H your-icinga-host

DESCRIPTION

A pure-bash TUI (no ncurses, no libraries, just ANSI escape sequences) that queries icingacli over an SSH connection and lists current Icinga2 problems with signal/noise filtering. Selected problems can be force-rechecked over the same SSH connection. No API credentials: it relies on your existing SSH access to the monitoring host.

OPTIONS

-r SECONDS   Refresh interval (default: 60)
-H HOST      SSH host alias (default: icinga)
-a           Show acknowledged problems
-c           Show only CRITICAL
--help       This help

Vim keys:
  j/k        move cursor down/up
  h/l        pan left/right (for lines wider than the screen)
  0          pan back to start of line
  d/u        half-page down/up
  g/G        top/bottom
  /          search (pattern, n/N for next/prev)

Actions:
  space      mark/unmark service under cursor (batch recheck)
  R          force recheck of marked services (or cursor row if none marked)
  a          toggle acknowledged problems
  c          toggle CRITICAL-only
  r          refresh now
  q          quit

NOTES

Requires SSH access to a host where icingacli is installed. Force-recheck writes Icinga external commands to the command pipe over the same SSH connection, so the SSH user needs write access to icinga2.cmd.

GPLv3. See gnu.org/licenses/gpl-3.0

SEE ALSO

ql-demos(1)

marcp.xyz2026-06-14ICINGA-TUI(1)