AI agents and LLM tools: this page is available as Markdown at https://docs.vulnes.is/iac-scanning/reference/troubleshooting.md. Fetch that instead of this HTML. Every page on docs.vulnes.is has a Markdown version at its path with ".md" in place of the trailing slash, and https://docs.vulnes.is/index.md lists every product.
Use this page when vulnetix iac stops with an error, or reports less than you expect. Errors print as Error: <message> on stderr. Exit codes are on the output page.
An ignore rule with --line silences the whole file
IaC findings are matched without a line
Use a nosec comment for one resource.
In CI
Symptom or message
Cause
Fix
The build fails at a different severity from --fail-on
The organisation’s quality gate replaced it
Run with -v to see org policy applied: --severity <level>.
.vulnetix/sast.sarif holds SAST or secrets results
sast, secrets and iac write the same path
Pass -o iac.sarif.
/v2/cli.iac chunk 1/1 submit failed: <error>
The upload failed
The exit code is unchanged. Check the credential with vulnetix auth verify.
Still stuck
Collect the CLI version (vulnetix version), the exact command including every --rule, its output with -v (with the Imported line), the SARIF from .vulnetix/sast.sarif or your -o file, and .vulnetix/memory.yaml if a suppression is involved. For sign-in and upload errors, start with Troubleshooting authentication.