Config file

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

runner = 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.


Core variables


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.