Environment Variables

The following table lists all primary configuration options available for UDMG. Each option can be set either as an HCL argument in the configuration file or overridden by an environment variable at runtime.

While environment variables take precedence over HCL arguments when both are provided, it is generally recommended to configure settings using HCL files to maintain clarity, consistency, and ease of management. Overriding with environment variables should be used sparingly, typically for temporary adjustments or in containerized deployment scenarios.

info

All HCL arguments described on this page use dot notation to reference their full path from the root of the configuration file.

Environment Variable Name	HCL Argument Name
`UDMG_INSTANCE_NAME`	`instance_name`
`UDMG_DATABASE_AUTO_MIGRATE`	`auto_migrate`
`UDMG_WORK_DIRECTORY_PATH`	`work_directory_path`
`UDMG_LOG_LEVEL`	`log.level`
`UDMG_LOG_FORMAT`	`log.format`
`UDMG_LOG_PATH`	`log.file`
`UDMG_LOG_ROTATE`	`log.rotate.enable`
`UDMG_LOG_ROTATE_FREQUENCY`	`log.rotate.frequency`
`UDMG_LOG_ROTATE_SIZE`	`log.rotate.size`
`UDMG_LOG_ROTATE_FORMAT`	`log.rotate.file_format`
`UDMG_JWT_SIGNING_KEY`	`jwt.signing_key`
`UDMG_JWT_ACCESS_TOKEN_DURATION`	`jwt.access_token.duration`
`UDMG_JWT_REFRESH_TOKEN_DURATION`	`jwt.refresh_token.duration`
`UDMG_API_LISTEN_INET`	`api.inet`
`UDMG_API_LISTEN_PORT`	`api.port`
`UDMG_API_SPEC_ENABLE`	`api.spec`
`UDMG_API_CSRF_ENABLE`	`api.csrf`
`UDMG_API_CORS_ENABLE`	`api.cors`
`UDMG_API_CORS_DOMAIN`	`api.cors_domain`
`UDMG_API_VERBOSE`	`api.verbose`
`UDMG_API_SECURE`	`api.secure.enable`
`UDMG_API_PUB_KEY`	`api.secure.pub_key`
`UDMG_API_PRIV_KEY`	`api.secure.priv_key`
`UDMG_TRANSFER_RETRY_DELAY`	`transfer.retry_delay`
`UDMG_TRANSFER_MAX_RETRY_DELAY`	`transfer.max_retry_delay`
`UDMG_TRANSFER_RETRY_BACKOFF`	`transfer.retry_backoff`
`UDMG_TRANSFER_MAX_RETRIES`	`transfer.max_retries`
`UDMG_TRANSFER_CHECK_INTERVAL`	`transfer.check_interval`
`UDMG_OBSERVABILITY_API_LISTEN_INET`	`observability.api.inet`
`UDMG_OBSERVABILITY_API_LISTEN_PORT`	`observability.api.port`
`UDMG_OBSERVABILITY_API_SPEC`	`observability.api.spec`
`UDMG_OBSERVABILITY_API_ENABLE`	`observability.api.enable`
`UDMG_OBSERVABILITY_DEBUG_ENABLE`	`observability.api.debug.enable`
`UDMG_OBSERVABILITY_DEBUG_USER`	`observability.api.debug.user`
`UDMG_OBSERVABILITY_DEBUG_PASSWORD`	`observability.api.debug.password`
`UDMG_PROMETHEUS_ENABLE`	`observability.prometheus.enable`
`UDMG_OPENTELEMETRY_ENABLE`	`observability.opentelemetry.enable`
`UDMG_OPENTELEMETRY_HOST`	`observability.opentelemetry.host`
`UDMG_OPENTELEMETRY_PORT`	`observability.opentelemetry.port`
`UDMG_DATABASE_ENGINE`	`database.engine`
`UDMG_DATABASE_NAME`	`database.instance`
`UDMG_DATABASE_HOSTNAME`	`database.hostname`
`UDMG_DATABASE_PORT`	`database.port`
`UDMG_DATABASE_USER`	`database.user`
`UDMG_DATABASE_PASSWORD`	`database.password`
`UDMG_DATABASE_MAX_CONNECTIONS`	`database.options.max_connections`
`UDMG_DATABASE_IDLE_CONNECTIONS`	`database.options.idle_connections`
`UDMG_DATABASE_MAX_RETRIES`	`database.options.max_retries`
`UDMG_DATABASE_INITIAL_INTERVAL`	`database.options.initial_interval`
`UDMG_DATABASE_MAX_INTERVAL`	`database.options.max_interval`
`UDMG_DATABASE_SECURE_ENABLE`	`database.secure.enable`
`UDMG_DATABASE_SECURE_MODE`	`database.secure.mode`
`UDMG_DATABASE_PUB_KEY`	`database.secure.pubKey`
`UDMG_DATABASE_PRIV_KEY`	`database.secure.priv_key`
`UDMG_SECURITY_PASSWORD_POLICY_MIN_LEN`	`security.password.min_lower_case`
`UDMG_SECURITY_PASSWORD_POLICY_MIN_UPPER`	`security.password.min_upper_case`
`UDMG_SECURITY_PASSWORD_POLICY_MIN_LOWER`	`security.password.min_lower_case`
`UDMG_SECURITY_PASSWORD_POLICY_MIN_NUMBERS`	`security.password.min_numbers`
`UDMG_SECURITY_PASSWORD_POLICY_MIN_SYMBOLS`	`security.password.min_symbols`
`UDMG_SECURITY_IGNORE_SYSTEM_USER_IP_FILTER`	`security.ignore_system_user_ip_filter`
`UDMG_SECURITY_FILE_PERMISSIONS`	`security.file_permissions`
`UDMG_SECURITY_DIRECTORY_PERMISSIONS`	`security.directory_permissions`
`UDMG_LDAP_ACCOUNT_SYNC_INTERVAL`	`ldap.ldap_account_sync_interval`
`UDMG_LDAP_USER_SYNC_INTERVAL`	`ldap.ldap_user_sync_interval`
`UDMG_ICAP_TIMEOUT`	`icap.timeout`
`UDMG_ICAP_RETRY`	`icap.retry`
N/A	`icap.vendor.name`
N/A	`icap.vendor.headers`
`UDMG_UAC_REST_ENABLE`	`uac.enable`
`UDMG_UAC_REST_URLS`	`uac.urls`
`UDMG_UAC_REST_USERNAME`	`uac.username`
`UDMG_UAC_REST_PASSWORD`	`uac.password`
`UDMG_UAC_REST_EVENT_NAME`	`uac.event_name`
`UDMG_UAC_REST_EVENT_TTL`	`uac.event_ttl`
`UDMG_PROTOCOL_SESSION_IDLE_TIMEOUT`	`protocol.session_idle_timeout`
`UDMG_CLUSTER_MODE`	`cluster.mode`
`UDMG_CLUSTER_HEARTBEAT`	`cluster.heartbeat`
`UDMG_CLUSTER_DEADLINE`	`cluster.deadline`
`UDMG_CLUSTER_CLIENT_PORT`	`cluster.client_port`
`UDMG_CLUSTER_CLUSTER_PORT`	`cluster.cluster_port`