Indexes

Sysand defaults to using the Sysand Index at sysand.com but it is possible to specify additional indexes or override this default index.

URLs for additional indexes can be specified with the command line argument --index. Multiple indexes can be given by invoking the argument multiple times, or by passing a comma separated list of URLs. The corresponding environment variable is SYSAND_INDEX, which also accepts comma separated lists of URLs.

Indexes specified with command line arguments or environment variables are prioritized when resolving dependencies but do not override indexes defined in configuration files.

The command line argument --default-index (and environment variable SYSAND_DEFAULT_INDEX) functions the same as --index but will override the default index https://sysand.com and any default indexes defined in configuration files.

The command line argument --no-index disables index use entirely: no index is consulted when resolving projects or their dependencies.

Defining an index in a configuration file

To add an index with the URL https://index.example.org simply add the following entry to your sysand.toml:

[[index]]
url = "https://index.example.org"

To override the default index add default = true. An index marked default = true replaces https://sysand.com rather than being added alongside it:

[[index]]
url = "https://index.example.org"
default = true

Index order

Indexes are tried in the order they are listed: indexes from --index or SYSAND_INDEX first, then indexes from configuration files in the order they appear, and default indexes last. A default index therefore has the lowest priority.