| .. _config: |
| |
| |
| User Configuration |
| ================== |
| User configuration and preferences can be specified in a user provided |
| configuration file, and usually also on the command line. |
| |
| Values specified in a user provided configuration file override the |
| defaults, while command line options take precedence over any other |
| specified configurations. |
| |
| |
| Configuration file |
| ------------------ |
| Users can provide a configuration file to override parameters in |
| the default configuration. |
| |
| Unless a configuration file is explicitly specified on the command line when |
| invoking ``bst``, an attempt is made to load user specific configuration from |
| ``$XDG_CONFIG_HOME/buildstream.conf``. On most Linux based systems, the location |
| will be ``~/.config/buildstream.conf`` |
| |
| |
| Default Configuration |
| --------------------- |
| The default BuildStream configuration is specified here for reference: |
| |
| .. literalinclude:: ../../buildstream/data/userconfig.yaml |
| :language: yaml |