Fork me on GitHub

Installing QIIME 2 using Docker

Warning

This site has been replaced by the new QIIME 2 “amplicon distribution” documentation, as of the 2025.4 release of QIIME 2. You can still access the content from the “old docs” here for the QIIME 2 2024.10 and earlier releases, but we recommend that you transition to the new documentation at https://amplicon-docs.qiime2.org. Content on this site is no longer updated and may be out of date.

Are you looking for:

Old content beyond this point… 👴👵

The following QIIME 2 distributions are available as Docker images:

  • amplicon

  • metagenome

  • pathogenome

  • tiny

Please replace <distribution> with your desired distribution in the installation instructions below.

1. Set up Docker

See https://www.docker.com for details.

2. Download desired QIIME 2 Distribution Image

In a terminal with Docker activated, run:

docker pull quay.io/qiime2/<distribution>:2024.10

3. Confirm the installation

Run the following to confirm that the image was successfully fetched.

docker run -t -i -v $(pwd):/data quay.io/qiime2/<distribution>:2024.10 qiime