The default configuration file for spicerack is expected to be found at /etc/spicerack/config.yaml. Its path can be changed in the CLI via the command-line switch --config-file PATH. A commented example configuration is available in the source code at doc/examples/config.yaml and included here below:

# Base path of the cookbooks. It's usually a checkout of a different repository that has all the cookbooks.
cookbooks_base_dir: /path/to/cookbooks/checkout
# Base directory for cookbook's logs.
logs_base_dir:  /var/log/spicerack
# Hostname and port to use for the special IRC logging using tcpircbot.
tcpircbot_port: 1234
# Optional HTTP/HTTPS proxy scheme://url:port to use for external calls. It's also exposed to the cookbooks.

The example file is also shipped, depending on the installation method, to:

  • $VENV_PATH/share/doc/spicerack/examples/config.yaml when installed in a Python virtualenv via pip.

  • /usr/local/share/doc/spicerack/examples/config.yaml when installed globally via pip.

  • /usr/share/doc/spicerack/examples/config.yaml when installed via the Debian package.