AI agents and LLM tools: this page is available as Markdown at https://docs.vulnes.is/cli/reference/environment-variables.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.
Flags win over environment variables wherever both exist. Variables used only by one product’s commands (the runtime sensor, the SIEM forwarder, the AI Firewall) are documented in that product’s segment.
ApiKey. Used only together with VULNESIS_ORG_ID. A leading <org>: is stripped.
VULNESIS_ORG_ID
Organisation UUID for the ApiKey, and the --noninteractive login org. It never names a manufacturer: when a manufacturer name resolves, the id is written as metadata.manufacturer.bom-ref (urn:uuid:<id>).
VVD_ORG, VVD_SECRET
SigV4 organisation and secret. Used only as a pair.
VULNESIS_CREDENTIALS_DIR
Directory of the home credentials file instead of ~/.vulnetix (read and write)
Endpoints
Variable
Default
Meaning
VULNESIS_API_URL
https://api-vdb.vulnes.is
VDB API base for scan and the language server, for a mock or self-hosted API. upload --base-url sets it for that run.
VULNESIS_WEB_URL
https://www.vulnes.is
Site base for the browser login’s device endpoints
GITHUB_API_URL
https://api.github.com
GitHub API for gha upload and the gha posture commands (GitHub Enterprise Server)
GitHub
Variable
Read by
GITHUB_TOKEN
gha upload (required to list the run’s artifacts), analyze, gha posture commands, triage, licence lookups
GH_TOKEN
analyze, gha posture commands, triage, licence lookups, after GITHUB_TOKEN. Then gh auth token.
Fallbacks for the flags of the scan family, cdx, aibom and cbom. A flag wins over its variable; for a label, the first variable set wins. See scan and Author and customise.
Variable
Flag
VULNESIS_PROJECT, then CI_PROJECT_NAME
--project
VULNESIS_ENVIRONMENT, then CI_ENVIRONMENT_NAME, ENVIRONMENT_NAME
--environment
VULNESIS_CLUSTER, then CLUSTER_NAME, KUBERNETES_CLUSTER_NAME
--cluster
VULNESIS_NAMESPACE, then POD_NAMESPACE, KUBERNETES_NAMESPACE
Output width when not a terminal and --width is not set
Caches
Variable
Default location
Effect
VULNESIS_SAST_CACHE_DIR
<user cache dir>/vulnetix/sast
SAST rule-result cache; point a CI cache step here. --no-cache turns it off.
VULNESIS_GRAPH_CACHE_DIR
<user cache dir>/vulnetix/graph
Per-file graph facts cache for analyze and scans
VULNESIS_MALSCAN_DEFS_DIR
<user cache dir>/vulnetix/malscan/definitions
Malscan threat-intel definitions
VULNESIS_NO_TOKEN_CACHE
~/.vulnetix/cache/tokens
Any value: do not keep SigV4 tokens on disk
VULNESIS_NO_LICENSE_CACHE
~/.vulnetix/cache/licenses
Any value: do not keep licence lookups
VULNESIS_NO_BINARY_CACHE
~/.vulnetix/cache/binaries
Any value: do not keep binary version detections
<user cache dir> is ~/.cache on Linux (or $XDG_CACHE_HOME), ~/Library/Caches on macOS and %LocalAppData% on Windows. VDB responses are cached under ~/.vulnetix/cache/vdb/, one directory per CLI version; old versions are cleaned at start.
Tuning
Variable
Default
Effect
VULNESIS_SCA_CONCURRENCY
6 (1 to 16)
Parallel cli.sca requests
VULNESIS_SCA_TIMEOUT
75 seconds (10 to 300)
Per-request limit for cli.sca
VULNESIS_SAST_WORKERS
CPU count
Concurrent rule evaluations
VULNESIS_SAST_SHARDS
by CPU count and rule count
Concurrent compile and evaluate shards; 1 compiles once
VULNESIS_SAST_NO_LANG_FILTER
unset
Any value: run rules for languages absent from the repository too
VULNESIS_REACHABILITY_CONCURRENCY
CPU count (1 to 32)
Files analysed in parallel by reachability
VULNESIS_GRAPH_WORKERS
CPU count
Parallel file parsing for the graph
GOMEMLIMIT
75% of the cgroup memory.max or physical memory
A scan sets a soft Go memory limit so the GC works harder before the kernel kills it. An explicit GOMEMLIMIT wins.
Debugging
Variable
Effect
VULNESIS_HTTP_TRACE
Any value: one stderr line per VDB request with start offset, duration, status, method, URL and connection setup time, e.g. [http#5] + 2241ms 3836ms 200 POST api-vdb.vulnes.is/v2/cli.sca net=0ms
VULNESIS_PPROF_DIR
Write cpu.pprof (and other profiles) for the run into this directory