๐ Jarvis v1.0.0 โ First Public Release
Jarvis is an open source web frontend for Prometheus Alertmanager โ interactive, realtime, and self-hosted.
Why Jarvis?
Most Alertmanager UIs are read-only dashboards. Jarvis is built for teams that need to act on alerts, not just observe them. It was inspired by Karma โ a great project โ but I was missing features that matter for day-to-day on-call work: full persistence across restarts, the ability to comment on individual alerts, a claiming system so the team knows who is handling what, and a solid foundation to build further operational tooling on top of.
- Realtime alerts via WebSocket โ no page reload required
- Persistent history โ full alert lifecycle in SQLite or PostgreSQL; survives restarts and reconnects
- Claiming โ assign an alert to yourself so the team sees who is on it
- Comments โ fingerprint-bound notes that survive re-fires
- Silence management โ create, edit, extend, delete; full Alertmanager proxy
- Expiring silence detection โ alerts approaching silence expiry surface as active 15 min early
- Multi-cluster โ poll multiple Alertmanager instances simultaneously
- Single binary โ Go backend embeds the Vite build; one container, no sidecar
- Authentication โ
none/internal(local accounts) /oidc(Keycloak, Authentik, Dex, โฆ)
What's in this release
Everything. This is the first public release, so the full feature set ships at once.
The core loop: Jarvis polls your Alertmanager clusters every 15 seconds (configurable), writes every alert lifecycle event to SQLite or PostgreSQL, and pushes real-time updates via WebSocket to the React frontend. When you reload the page or restart the container, history is still there.
On top of that: label-based filtering with full Alertmanager matcher syntax (= / != / =~ / !~), URL-serialized so filters are shareable. Card and list views. A detail panel that shows labels, annotations, firing history, occurrence stats, claim ownership, and a comment thread โ all bound to the alert's fingerprint and persisted across re-fires. A silence builder with a live match preview so you know exactly what you're silencing before you commit.
Security-wise: distroless container, read-only filesystem, no-new-privileges, strict CSP, per-IP rate limiting on all mutating endpoints, SBOM + provenance attestations and keyless image signing on every release.
Full feature reference โ README.md
Getting Started
No clone needed โ runs entirely from the published image.
All configuration options โ README โ Configuration
Local
mkdir jarvis && cd jarvisCreate a compose.yml:
services:
jarvis:
image: ghcr.io/kj187/jarvis:1.0.0
ports:
- "8080:8080"
volumes:
- jarvis_data:/data
environment:
JARVIS_CLUSTER_1_NAME: production
JARVIS_CLUSTER_1_ALERTMANAGER_URL: http://alertmanager:9093
restart: unless-stopped
read_only: true
tmpfs:
- /tmp
security_opt:
- no-new-privileges:true
cap_drop:
- ALL
volumes:
jarvis_data:docker compose up -d
# http://localhost:8080Kubernetes
Helm chart
helm install jarvis oci://ghcr.io/kj187/charts/jarvis \
--version 1.0.0 \
--set clusters[0].name=production \
--set clusters[0].alertmanagerUrl=http://alertmanager:9093 \
--set persistence.enabled=trueFull docs โ README.md ยท Configuration ยท Helm chart ยท Authentication
Tech stack
Go 1.25 ยท Echo v4 ยท SQLite / PostgreSQL (CGO-free) ยท React 19 ยท TypeScript ยท Vite ยท Tailwind CSS v4 ยท Zustand v5 ยท TanStack Query v5 ยท distroless container
Built with AI โ Jarvis was developed entirely using AI coding assistants. This is an intentional workflow choice, not a shortcut: the codebase follows established Go and React best practices, enforces security standards through automated tooling (gosec, govulncheck, golangci-lint, pnpm audit) on every commit and in CI, and applies defense-in-depth measures (strict CSP, read-only container filesystem, no-new-privileges).
Feedback and contributions welcome โ see CONTRIBUTING.md. If Jarvis is useful to you, a โญ on GitHub is always appreciated!
Container Image
docker pull ghcr.io/kj187/jarvis:1.0.0Verify with Cosign
cosign verify ghcr.io/kj187/jarvis@sha256:521be7e2a03fcf11476935e0e890e3526dabcb4c173d1487abf08bb57daaf09f \
--certificate-identity-regexp="https://github.com/kj187/jarvis/.*" \
--certificate-oidc-issuer="https://token.actions.githubusercontent.com"Changelog 1.0.0
Added
- Initial open source release of Jarvis
- Realtime alert view via WebSocket (card and list layout)
- Persistent alert history stored in SQLite (WAL mode, single-writer)
- PostgreSQL support via DSN-based dialect detection (
JARVIS_DB_DSN=postgres://...) - Alert claiming โ assign yourself to an alert so the team sees who is on it
- Alert comments โ fingerprint-bound notes that survive restarts and re-fires
- Full label-based filtering with
=/!=/=~/!~matchers, URL-serialized - Alert detail panel (labels, annotations, firing history, statistics, AI prompt section)
- Summary/description section in alert detail panel
- Multi-cluster support via
JARVIS_CLUSTER_N_*environment variables - Silence management โ create, edit, extend, delete; full Alertmanager proxy
- Silence history tab in alert detail panel
- Inline claim/release and silence controls in list view
- 60s grace period to prevent ghost-resolves
- Immutable append-only audit log for full alert lifecycle history
- 20-minute in-memory window for recently resolved alerts (survives brief poll gaps)
- Immediate poll trigger after silence create/edit/delete actions
- Paginated resolved view with configurable page size
- Per-state alert counts displayed in navigation pills
- User settings panel (page size, view preferences)
- Authentication via
JARVIS_AUTH_MODEโnone(default) orlocal(username/password) - Login/setup UI and admin panel for local auth mode
- Dark/light theme toggle
- Responsive header with mobile hamburger menu
- Helm chart with OCI publish workflow (
oci://ghcr.io/kj187/charts/jarvis) - Test Alertmanager in dev compose for local development without a live cluster
- Single self-contained binary: Go backend embeds the Vite frontend build
- Distroless container image with read-only filesystem and no-new-privileges
- SBOM attestation, provenance attestation, and keyless image signing on all releases
- GitHub Actions CI pipeline (Go tests + lint + govulncheck; frontend tests + build)
- Helm chart unit tests via helm-unittest integrated into CI and pre-commit
Changed
- Upgraded Vite from 6.4.3 to 8.0.16
- Upgraded TypeScript from 5.9.3 to 6.0.3; removed deprecated
baseUrlfrom tsconfig (paths work standalone since TS 5.5, Vite alias is defined independently) - Upgraded golang.org/x/crypto from 0.50.0 to 0.53.0
- Upgraded GitHub Actions:
actions/setup-go5.6.0โ6.4.0,codecov/codecov-action4.6.0โ7.0.0,docker/setup-qemu-action3.7.0โ4.1.0,github/codeql-action3.36.2โ4.36.2,sigstore/cosign-installer3.9.1โ4.1.2
Fixed
- Fingerprint regex tightened to match Alertmanager's actual format
- Structured request access logging via
slog - CSP
connect-srcrestricted to'self'only - Stable sort in resolved view โ tie-break by severity then alertname
- Claim release delayed by 65 s to survive grace-period re-fires
- Comment ownership checks use
user_id; delete icon hidden for other users' comments - Alert card and list components display correctly in light theme
- Force list view for resolved and suppressed state tabs (card layout not useful there)
- View toggle hidden when state filter is not active
- Default state filter set to
activeon bare URL load - Release workflow: generate release notes from CHANGELOG instead of GitHub auto-notes
- Release workflow: add container image digest, cosign verify block, and contributor list to GitHub Release body
- Release workflow: rewrite release body assembly with
printf; useghCLI for release creation; exclude bot accounts from contributor list - Containerfile: include
pnpm-workspace.yamlin COPY step to fix frontend build in container
Security
- Per-IP rate limiting on all mutating endpoints
- Maximum length enforcement on all free-text input fields (claims, comments, silence matchers)
- Comment
DELETEscoped to fingerprint to prevent cross-alert IDOR sslmode=requireenforced in all production PostgreSQL documentation examples