Skip to content

Netfox 0.8.0

Latest

Choose a tag to compare

@gfazioli gfazioli released this 13 Jun 12:10
· 6 commits to main since this release

Netfox 0.8.0 — your network, on your Prometheus + Grafana dashboards.

Netfox can now expose what it sees as a Prometheus-compatible metrics endpoint, so the data you already trust in the app — open ports, who's online, throughput — flows straight into your own monitoring. This one came from the community: a homelab user asked for it, and here it is. Same no-account / no-cloud / no-telemetry promise.

📈 Prometheus metrics endpoint

Turn it on in Settings → Integrations and Netfox serves /metrics in the Prometheus text exposition format. Point your Prometheus scrape config at it, build your Grafana panels, done.

What it exposes:

  • Open ports per host — plus an open-port count per device
  • Port state over time — when each port's state was last observed
  • Device presence — online/offline state and last-seen time per device
  • Throughput — this Mac's network rx/tx, in bytes per second
  • Alerts — counts by type

The host label is each device's IP address, so the series line up with what you see everywhere else in Netfox.

🔒 Off by default, yours to expose

The endpoint is a listening socket, so it ships locked down:

  • Off by default — nothing listens until you opt in
  • Localhost-only by default — flip one switch to expose it to your LAN, so a Prometheus running on your NAS or another host can scrape it
  • Optional bearer token — set one before you expose it to the network; unauthenticated scrapes get a 401
  • Read-only — it only ever serves the current snapshot; Netfox never pushes anywhere
  • Live whenever Netfox is running — it stays resident in the menu bar, so it keeps serving with the main window closed

🎭 Demo Mode

Demo Mode masks the on-screen UI for screenshots — it does not mask the endpoint, which always returns real data so your dashboards stay accurate. Switch the endpoint off if you're recording a demo with it enabled.

📚 Docs

Full setup, the complete metric list, and a sample Prometheus scrape config: https://netfox.app/docs/integrations


No account, no cloud, no telemetry — every observation lives on your Mac. Requires macOS 15 (Sequoia) or later. Universal binary (Apple Silicon + Intel).