Configuration#
Sysand offers three ways of configuring its behavior:
command line options
environment variables
configuration files
Command line options override corresponding environment variables. Indexes
given on the command line or in environment variables are tried before
indexes from configuration files but do not remove them; --default-index
and --no-index are the exceptions that replace or disable configured
indexes. See Indexes for the exact order.
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.