selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
opnsense-exporter logo

Self-host opnsense-exporter

v0.0.19

Prometheus exporter for OPNsense firewall metrics

AlphaOpen SourceApache-2.0
Updated9 hours ago
LanguageGo
Setup difficultyModerate
Stars
274
Port
8080 (Prometheus metrics endpoint)
Docker
ghcr.io/athennamind/opnsense-exporter
Install with Docker
opnsense-exporter screenshot 1

What is opnsense-exporter?

OPNsense Exporter is a Go-based Prometheus exporter that pulls metrics from an OPNsense firewall's REST API. It runs on any host with API reachability, not on the firewall itself. Collectors cover ARP tables, cron jobs, WireGuard, Unbound DNS, OpenVPN, IPsec, packet-filter stats, firmware versions, Kea DHCP leases, thermal sensors, CARP VIPs, PF state tables, and mbuf clusters — each toggleable via flags. A Docker image lives on GHCR; Docker Compose and Kubernetes manifests are provided. A ready-made Grafana dashboard (ID 21113) visualizes the data. Configuration uses CLI flags or environment variables for API credentials, TLS, and per-instance labels.

Should you self-host opnsense-exporter?

opnsense-exporter scores 44/100 on selfhost.directory (how scoring works) and ranks #80 of 104 in Monitoring & observability. It has 274 GitHub stars.

It shipped 7 stable releases in the past year. The latest, v0.0.19, came out on 21 October 2026. New versions land roughly every 5 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is grafana (90/100, 77 568 stars). It scores higher overall, so compare the two before you pick. See opnsense-exporter vs grafana side by side.

Features

  • ARP table metrics
  • CARP VIP status metrics
  • Cron task metrics
  • Firewall (pf) metrics
  • Firmware metrics
  • IPsec metrics
  • Kea DHCPv4/v6 lease metrics
  • Mbuf cluster usage metrics
  • Multi-instance labeling
  • OpenVPN metrics
  • PF state table usage metrics
  • Temperature sensor metrics
  • TLS certificate verification control
  • Unbound DNS metrics
  • WireGuard metrics

opnsense-exporter README

How to install opnsense-exporter

Install opnsense-exporter with Docker

Environment variables
OPNSENSE_EXPORTER_OPS_API_KEY, OPNSENSE_EXPORTER_OPS_API_SECRET, OPNSENSE_EXPORTER_OPS_PROTOCOL, OPNSENSE_EXPORTER_OPS_API, OPNSENSE_EXPORTER_OPS_INSECURE, OPNSENSE_EXPORTER_INSTANCE_LABEL, and all disable-* flags

docker run -p 8080:8080 ghcr.io/athennamind/opnsense-exporter:latest
/opnsense-exporter
--log.level=debug
--log.format=json
--opnsense.protocol=https
--opnsense.address=ops.example.com
--opnsense.api-key=your-api-key
--opnsense.api-secret=your-api-secret
--exporter.instance-label=instance1
--web.listen-address=:8080

Replace ops.example.com, your-api-key, your-api-secret, and instance1 with your own values

opnsense-exporter releases & version history

More in Infrastructure Monitoring

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…