Amazon S3 remote

The nextstrain remote family of commands can list, download, upload, and delete Nextstrain datasets and narratives hosted on Amazon S3. This functionality is primarily intended for use by the Nextstrain team and operators of self-hosted Auspice instances. It is also used to manage the contents of Nextstrain Groups that have not migrated to using the remote.

Remote paths

Remote paths start with s3:// and specify the bucket name and individual file path/prefix, e.g. s3://my-bucket/some/prefix.

The bucket must already exist.


All actions require AWS credentials. The following environment variables can be used to provide credentials:


Keys for your AWS IAM user, provided by your AWS account administrator (e.g. the Nextstrain team if you’re a Nextstrain Groups user).

Amazon’s documentation includes more information on these environment variables. A persistent credentials file (~/.aws/credentials) is also supported.