Configuration File and Variables

Each of torero's 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. TORERO_APPLICATION_WORKING_DIR)
2. A single configuration file. Location precedence rules are shown below
   a. Passed in using --config <path> from the CLI when launching torero
   b. Path set using TORERO_CONFIG environment variable
   c. ~/.torero.d/torero.conf
   d. /etc/torero/torero.conf
   
3. Default value

To view your torero's loaded configuration variables, simply run torero version --show-config.

If you do use a configuration file, please reference this example as a starting point.

[application]
#mode             = local
#auto_accept_eula = false
#cluster_id       = bullpen
#working_dir      = ~/.torero.d

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

[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/torero
#timestamp_timezone = utc

[runner]
#announcement_address =
#certificate_file     = /etc/torero/torero.crt
#listen_address       = 127.0.0.1
#port                 = 50051
#private_key_file     = /etc/torero/torero.key
#use_tls              = true

[secrets]
#encrypt_key_file =

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

[store]
#backend                      = local
#etcd_hosts                   = "localhost:2379" # space separated list
#etcd_use_tls                 = true
#etcd_ca_certificate_file     =
#etcd_certificate_file        =
#etcd_client_cert_auth        = false
#etcd_private_key_file        =

[terminal]
#no_color           = false
#timestamp_timezone = utc

For a full list of configuration options, see variables documentation.