Configuration#
Sysand offers three ways of configuring its behavior:
command line options
environment variables
configuration files
Command line options override corresponding environment variables. Indexes are the exception: they combine across all three sources, in the order described in Indexes.
Credentials for authenticated indexes are configured through SYSAND_CRED_*
environment variables; see Authentication.
Configuration files#
Sysand looks for a sysand.toml file in the root directory of the current
project (see the print-root command), or in the current
directory when not inside a project. Sysand also reads a user-level
configuration file at <config dir>/sysand/sysand.toml (for example
~/.config/sysand/sysand.toml on Linux).
Automatic discovery of both files can be disabled with the command line
option --no-config or by setting the environment variable
SYSAND_NO_CONFIG to true.
The command line option --config-file (or environment variable
SYSAND_CONFIG_FILE) can be used to specify the path to an additional config
file. A file given with --config-file is still read when --no-config is
set, since --no-config disables discovery only.
When multiple configuration files apply, entries from --config-file come
before the user-level file, which comes before the project-level file.