nextstrain view

Visualizes a completed pathogen build in Auspice, the Nextstrain visualization app.

The data directory should contain sets of dataset files like:




usage: nextstrain view [options] <directory>
       nextstrain view --help

Positional Arguments


Path to directory containing JSONs for Auspice


--help, -h

Show a brief help message of common options and exit


Allow other computers on the network to access the website (alias for –host=


Listen on the given hostname or IP address instead of the default “”

Default: “”


Listen on the given port instead of the default port 4000

Default: 4000

runner selection options

Select the method for running a Nextstrain computing environment, if the default is not suitable.


Run commands inside a container image using Docker. (default)


Run commands on the native host, outside of any container image.

development options

These should generally be unnecessary unless you’re developing Nextstrain.


Container image name to use for the Nextstrain computing environment

Default: “nextstrain/base”


Program to run inside the build environment

Default: “auspice”

development options for –docker


Replace the image’s copy of augur with a local copy


Replace the image’s copy of auspice with a local copy


Replace the image’s copy of fauna with a local copy


Replace the image’s copy of sacra with a local copy


Additional arguments to pass to docker run

Default: []