Skip to content

Container Configuration

The container options below can be used to authenticate to use the software (HL_LICENSE), to send data to the platform (HL_LLM_PROXY_CLIENT_ID and HL_LLM_PROXY_CLIENT_SECRET), or to configure networking behavior.

Variables

Environment KeyRequiredDefaultExample ValueDescription
HL_LICENSETrueLicense for use obtained from HiddenLayer.
HL_LLM_PROXY_ENABLE_UNSECURED_ROUTE_PASSTHROUGHTruetrueFlag to handle unmapped routes, the AI Runtime Security supports passing through all HTTP endpoints that are not explicitly mapped.
HL_LLM_PROXY_CLIENT_IDFalseThe HiddenLayer API key. Required for an Runtime Security hybrid deployment.
HL_LLM_PROXY_CLIENT_SECRETFalseThe HiddenLayer API secret. Required for an Runtime Security hybrid deployment.
HL_LLM_PROXY_DOWNSTREAM_TIMEOUT_SECONDSFalse600600
HL_LLM_PROXY_HTTP_HOSTFalse0.0.0.0
HL_LLM_PROXY_HTTP_PORTFalse80008000While the port range is 1-65535, the recommended port range is 1025-65535 since opening ports 1-1024 requires root permissions.
HL_LLM_PROXY_LOG_LEVELFalseINFODEBUG
HL_LLM_PROXY_LOG_LEVEL_PAYLOADSFalseparsedparsedExcludes submitted prompts and LLM responses from INFO-level logging and above.

Available values: none and parsed.
HL_LLM_PROXY_MLDR_BASE_URLFalsehttps://api.us.hiddenlayer.aihttps://api.us.hiddenlayer.ai
HL_LLM_PROXY_MLDR_COLLECT_PROMPTFalsetruefalseCollects prompts and response with the security analysis sent to the HiddenLayer Console. This allows the review and evaluation of Interactions on the Console in the context of the user's prompt and response.

Setting to false disables this. If this setting is not configured, the default behavior is set to true.
HL_LLM_PROXY_MLDR_CONNECTION_TYPEFalsedisabledhybrid or disabledHybrid mode enables metadata to be sent to HiddenLayer to power the console experience. In hybrid mode, HL_LLM_PROXY_CLIENT_ID and HL_LLM_PROXY_CLIENT_SECRET must be set.

Setting to disabled will remove any connections back to HiddenLayer.
HL_LLM_PROXY_MLDR_DEFAULT_REQUESTERFalseunknownunknown
HL_LLM_PROXY_MLDR_ENABLE_REMOTE_CONFIGURATIONFalsetruefalseEnables policy support. Setting to false disables Policy support for Runtime Security.
HL_LLM_PROXY_MLDR_RETRY_COUNTFalse33
HL_LLM_PROXY_OUTBOUND_PROXY_URLFalsehttps://outbound-proxy.example.com:8080Enables routing outbound connections through a customer-managed forward proxy.
HL_LLM_PROXY_TOKEN_URLFalsehttps://api.us.hiddenlayer.aihttps://auth.hiddenlayer.ai