Natively installing QIIME 2¶
This guide describes how to natively install the QIIME 2 Core 2021.8 distribution.
Miniconda provides the
conda environment and package manager, and is
the recommended way to install QIIME 2. Follow the Miniconda instructions
for downloading and installing Miniconda. You may choose either Miniconda2 or
Miniconda3 (i.e. Miniconda Python 2 or 3). QIIME 2 will work with either
version of Miniconda. It is important to follow all of the directions
provided in the Miniconda instructions, particularly ensuring that you run
conda init at the end of the installation process, to ensure that your
Miniconda installation is fully installed and available for the following
After installing Miniconda and opening a new terminal, make sure you’re
running the latest version of
conda update conda
conda install wget
Install QIIME 2 within a
Once you have Miniconda installed, create a
conda environment and install
the QIIME 2 Core 2021.8 distribution within the environment. We highly
recommend creating a new environment specifically for the QIIME 2 release
being installed, as there are many required dependencies that you may not
want added to an existing environment. You can choose whatever name you’d
like for the environment. In this example, we’ll name the environment
qiime2-2021.8 to indicate what QIIME 2 release is installed (i.e.
From the above tabs, please choose the installation instructions that are appropriate for your platform.
wget https://data.qiime2.org/distro/core/qiime2-2021.8-py38-osx-conda.yml conda env create -n qiime2-2021.8 --file qiime2-2021.8-py38-osx-conda.yml # OPTIONAL CLEANUP rm qiime2-2021.8-py38-osx-conda.yml
wget https://data.qiime2.org/distro/core/qiime2-2021.8-py38-linux-conda.yml conda env create -n qiime2-2021.8 --file qiime2-2021.8-py38-linux-conda.yml # OPTIONAL CLEANUP rm qiime2-2021.8-py38-linux-conda.yml
# These instructions are identical to the Linux (64-bit) instructions wget https://data.qiime2.org/distro/core/qiime2-2021.8-py38-linux-conda.yml conda env create -n qiime2-2021.8 --file qiime2-2021.8-py38-linux-conda.yml # OPTIONAL CLEANUP rm qiime2-2021.8-py38-linux-conda.yml
Now that you have a QIIME 2 environment, activate it using the environment’s name:
conda activate qiime2-2021.8
To deactivate an environment, run
Test your installation¶
You can test your installation by activating your QIIME 2 environment and running:
If no errors are reported when running this command, the installation was successful!
Now that you have the Core distribution installed, check out the q2cli docs to get familiar with the QIIME 2 command-line interface (it is used extensively in the tutorials). After that, try out the QIIME 2 tutorials for examples of using QIIME 2 to analyze microbiome datasets. You might also try installing other QIIME 2 interfaces.
How do I update to the newest version of QIIME 2?¶
In order to to update/upgrade to the newest release, you simply install the newest version in a new conda environment by following the instructions above. Then you will have two conda environments, one with the older version of QIIME 2 and one with the newer version.
(Re-)Activating QIIME 2¶
If at any point during the analysis the QIIME 2 conda environment is closed or deactivated, QIIME 2 2021.8 can be activated (or reactivated) by running the following command:
conda activate qiime2-2021.8
To determine the currently active conda environment, run the following command and look for the line that starts with “active environment”: