homepage/docs/widgets/services/opnsense.md

title	description
OPNSense	OPNSense Widget Configuration

OPNSense - OPNsense is an open source, FreeBSD-based firewall and routing software developed by Deciso, a company in the Netherlands that makes hardware and sells support packages for OPNsense.

The API key & secret can be generated via the webui by creating a new user at System/Access/Users. Ensure "Generate a scrambled password to prevent local database logins for this user" is checked and then edit the effective privileges selecting only:

• Diagnostics: System Activity
• Status: Traffic Graph

Finally, create a new API key which will download an apikey.txt file with your key and secret in it. Use the values as the username and password fields, respectively, in your homepage config.

Allowed fields: ["cpu", "memory", "wanUpload", "wanDownload"].

widget:
  type: opnsense
  url: http://opnsense.host.or.ip
  username: key
  password: secret