Using Configuration Variables

Configuration Variables

For each gateway, the configuration variables can be set via an environment variable or a configuration file. The priority order for reading in each configuration variable is shown below.

1. Environment variable (e.g., GATEWAY_APPLICATION_WORKING_DIR)
2. A single configuration file. Location precedence rules are:
   a. Passed in using --config <path> from the CLI when launching gateway
   
   b. Path set using GATEWAY_CONFIG environment variable
   
   c. ~/.gateway.d/gateway.conf
   
   d. /etc/gateway/gateway.conf
   
3. Default value

To view loaded configuration variables in a gateway, simply run:

iagctl version --show-config

Configuration File Example

If you use a configuration file, reference this example as a starting point:

[application]
#mode             = local
#auto_accept_eula = false
#cluster_id       = cluster_1
#working_dir      = ~/.gateway.d

[client]
#certificate_file =
#host             =
#port             = 50051
#private_key_file =
#use_tls          = true

[commander]
#certificate_file     = /etc/gateway/connect.crt
#enabled              = false
#server_ha_enabled    = false
#server_ha_is_primary = false
#host                 = 127.0.0.1
#port                 = 8080

[features]
#ansible_enabled  = true
#hostkeys_enabled = true
#opentofu_enabled = true
#python_enabled   = true

[log]
#console_json       = false
#file_enabled       = true
#file_json          = false
#level              = INFO
#server_dir         = /var/log/gateway
#timestamp_timezone = utc

[secrets]
#encrypt_key_file =

[server]
#api_key_expiration = 1440
#certificate_file   = /etc/gateway/gateway.crt
#listen_address     = 127.0.0.1
#port               = 50051
#private_key_file   = /etc/gateway/gateway.key
#use_tls            = true

[store]
#backend = local

[terminal]
#no_color           = false
#timestamp_timezone = utc

Config Variable References

Available gateway configuration variables are referenced below:

• Application
• Client
• Commander
• Features
• Log
• Runner
• Secrets
• Server
• Store
• Terminal