Config file

Nextstrain CLI uses an INI-style configuration file to store information about the runtimes that are set up. For example:

[core]
runner = docker

[docker]
image = nextstrain/base:build-20230623T174208Z

The default configuration file is ~/.nextstrain/config. This path may be overridden entirely by the NEXTSTRAIN_CONFIG environment variable. Alternatively, the path of the containing directory (i.e. ~/.nextstrain/) may be overridden by the NEXTSTRAIN_HOME environment variable.

Sections

• Core variables

• Docker runtime variables

• Singularity runtime variables

• AWS Batch runtime variables

Core variables

core.runner

Short name of the default runtime. Typically set by running one of:

nextstrain setup --set-default <runtime>
nextstrain check-setup --set-default

If not set, the Docker runtime (docker) is used.