Forgehaven Labs

Support · FireGlance

FireGlance Support

Email [email protected]. Include your pfSense version and the pfREST package version if the question is about connecting.

Getting started

FireGlance is a read-only iPhone dashboard for pfSense® firewalls running the free pfREST API package.

  1. Try Demo mode first: every screen, including Pro screens, works with realistic sample data and no firewall.
  2. On the firewall, install the free open-source pfSense REST API package ("pfREST"): instructions at pfrest.org, or System > Package Manager. About two minutes.
  3. Create an API key on the firewall under System > REST API > Keys (basic-auth also works if enabled in the package settings).
  4. In FireGlance, add the firewall with the same host and port you use for the webConfigurator, then approve its certificate fingerprint once.

Frequently asked

FireGlance can't connect. What do I check first?

1) Is the pfREST package installed on the firewall? pfSense CE has no built-in REST API; if FireGlance reports "REST API package not found", the firewall's web interface answered instead of the API. 2) Is the address right? Use the same host/port as the webConfigurator (usually HTTPS on 443, sometimes 8443). 3) Are you on the same network? FireGlance talks directly to the firewall: be on the LAN or connected via VPN. 4) Is the API key valid? Create one under System > REST API > Keys.

It says the certificate isn't trusted / shows a fingerprint

That's the point: pfSense boxes almost always use self-signed certificates. FireGlance shows the certificate's SHA-256 fingerprint and asks you to approve it once per firewall. To verify it matches, check System > Certificates on the firewall and compare the SHA-256 digest. After approval the fingerprint is pinned.

The fingerprint changed and FireGlance refuses to connect

This protects you from man-in-the-middle attacks. If you changed the certificate yourself (renewed or regenerated it), edit the firewall entry in FireGlance and approve the new fingerprint. If you did not change it, investigate before trusting.

What's free and what's Pro?

Free forever: one firewall with the full dashboard, interfaces, gateways, services, and DHCP leases. Pro ($9.99, one-time, never a subscription) adds multiple firewalls, the firewall-log viewer, and Home Screen widgets. Restore a previous purchase at Settings > FireGlance Pro > Restore Purchases.

Does FireGlance change anything on my firewall?

No. v1 is strictly read-only. It sends only read requests; it cannot edit rules, restart services, or modify configuration.

Which pfSense versions work?

Any pfSense CE or Plus version supported by the pfREST v2 package (see pfrest.org for its compatibility table). FireGlance pins to the /api/v2 endpoints.

Is my data collected?

No. See the privacy policy: no analytics, no accounts, no third-party SDKs, no server of ours. Credentials stay in the iOS Keychain on your device.

Reporting a bug

Email [email protected] with your iPhone model and iOS version, your pfSense version and pfREST package version, and what you did, what you expected, and what happened. Screenshots are welcome; mask any public IPs.

FireGlance is an independent project, not affiliated with, endorsed by, or supported by Netgate. pfSense is a registered trademark of Rubicon Communications, LLC (Netgate).