# opnsense-exporter

> Self-hosted Prometheus exporter for OPNsense metrics via REST API — ARP, WireGuard, Unbound, OpenVPN, IPsec, firewall, firmware, DHCP, temperature, CARP. Grafana dash.

- **Category:** Monitoring & observability
- **Licence:** Apache-2.0
- **Latest version:** v0.0.19
- **Open source:** oss
- **Languages:** Go
- **Platforms:** Docker, Docker Compose, Kubernetes
- **Tags:** Monitoring, Metrics, Grafana, Infrastructure, Firewall, Network Monitoring, Kubernetes, Docker, Prometheus, Prometheus exporter, Opnsense, Opnsense Firewall

## Description

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.

## Links

- [Homepage](https://github.com/AthennaMind/opnsense-exporter)
- [Docker](ghcr.io/athennamind/opnsense-exporter)
- [GitHub Repository](https://github.com/AthennaMind/opnsense-exporter)
- [Grafana Dashboard](https://grafana.com/grafana/dashboards/21113)
- [Metrics Documentation](https://github.com/AthennaMind/opnsense-exporter/blob/main/docs/metrics.md)
- [Kubernetes Deployment](https://github.com/AthennaMind/opnsense-exporter/tree/main/deploy/k8s)

---
Source: https://selfhost.directory/project/opnsense-exporter