evilbit-labs/opnDossier

Audit and document OPNsense and pfSense configurations in your GitHub Actions workflow

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 4, 2026
License
Apache 2.0

Pinned Snippet

workflow.ymlSHA-pinned
uses: evilbit-labs/opndossier@f74614de515eff6ad0d087ad47b9d9b192b1a9f3 # v1.5.0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
commandopnDossier sub-command to run: audit | convert | diff | display | sanitize | validate | versionnoaudit
config-filePath to the OPNsense or pfSense config.xml file (relative to workspace root)yes
formatOutput format for convert/audit: markdown | json | yaml | text | htmlno""
outputPath to write the output file (relative to workspace root)no""
argsAdditional arguments to pass to opnDossier (split on whitespace; quoted strings with spaces are not preserved)no""
versionImage tag to pull from ghcr.io/evilbit-labs/opndossier. RECOMMENDED for production CI: pin the action itself to a full commit SHA (e.g. `uses: EvilBit-Labs/opnDossier@<40-char-sha> # v1.6.0`) and leave this input at the default release tag. A version tag (e.g. `v1.6.0`) is an acceptable middle ground. `latest` is accepted but unpinned and moving — not supported for production use. See the README "Pinning" section for the full guidance: https://github.com/EvilBit-Labs/opnDossier#pinning nov1.6.0

no outputs