Skip to content
Configuration

Configuration

The Runtime Sensor is configured entirely through ENDURA_* environment variables. This page is the canonical reference for every supported variable, its default, and its behavior.

How these variables are supplied to the sensor depends on your deployment method:

  • Bare-metal / native packages: set them in the environment file at /opt/endura/sensor/environ, which the systemd service reads at startup. See your platform’s deployment guide.
  • Kubernetes (Helm): supply non-sensitive values through sensor.env.* Helm values and sensitive values through the endura-sensor-secrets Secret. See the Kubernetes deployment guide.

Required for Team Server Integration

These variables are required when reporting data to a centralized Team Server instance.

VariableDescription
ENDURA_LICENSE_KEYThe license key provided by Endura Security.
ENDURA_TEAM_SERVERThe fully qualified URL of your Team Server instance.
ENDURA_SENSOR_TOKENThe sensor token generated by Team Server for this sensor.

Optional Configuration

VariableDefaultDescription
ENDURA_BATCHER_AUTOFLUSHfalseSet to true to automatically submit violations as they are detected instead of batching them.
ENDURA_EXIT_ZEROfalseSet to true to make every endura command exit with status code 0 even when an error is reported. Useful in CI/CD pipelines where a failing sensor command should not fail the build.
ENDURA_HTTP_TIMEOUT5Number of seconds the HTTP client will wait when interacting with Team Server.
ENDURA_JOB_TIMEOUTdisabledMaximum duration a job may run before it is automatically purged, specified with a suffix: s (seconds), m (minutes), h (hours), or d (days). For example, 2h for two hours. Set to 0 or leave unset to disable.
ENDURA_LOG_FILE/var/log/endura/sensor.logFully qualified path to a log file on disk for saving logs.
ENDURA_LOG_LEVELinfoLog level of either trace, debug, info, warn, or error.
ENDURA_SENSOR_KILL_TASKtrueSet to false to disable killing tasks/processes that trigger violations.
ENDURA_SENSOR_POLICY_NOCACHEfalseSet to true to re-evaluate policy on every event instead of reusing the cached outcome for repeated events. The default (false) reuses cached outcomes to conserve CPU; enabling it raises CPU usage and is intended for diagnostics.
ENDURA_TLS_VERIFYtrueControls TLS certificate verification when communicating with Team Server. Setting to false is dangerous and only suitable for testing.