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:
the QIIME 2 homepage? That’s https://qiime2.org.
learning resources for microbiome marker gene (i.e., amplicon) analysis? See the QIIME 2 amplicon distribution documentation.
learning resources for microbiome metagenome analysis? See the MOSHPIT documentation.
installation instructions, plugins, books, videos, workshops, or resources? See the QIIME 2 Library.
general help? See the QIIME 2 Forum.
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