zuul-client/doc/source/configuration.rst
Matthieu Huin 677de34472 Add support for XDG-compliant config file
zuul-client will also look by default for the
$XDG_CONFIG_HOME/zuul/client.conf file when looking for user settings.

Change-Id: I60d59fceb1d4e4d767ca9e952a8ecc1630eba0a8
2021-06-01 10:34:01 +02:00

923 B

title

Configuration

Configuration

The web client will look by default for a $HOME/.config/zuul/client.conf or a $HOME/.zuul.conf file for its configuration. The file should consist of a [webclient] section with at least the url attribute set. The optional verify_ssl can be set to False to disable SSL verifications when connecting to Zuul (defaults to True). An authentication token can also be stored in the configuration file under the attribute auth_token to avoid passing the token in the clear on the command line. A default tenant can also be set with the tenant attribute.

Here is an example of a configuration file that can be used with zuul-client:

/examples/.zuul.conf

It is also possible to run the web client without a configuration file, by using the --zuul-url option to specify the base URL of the Zuul web server.