Natively installing QIIME 2¶
This guide describes how to natively install the QIIME 2 Core 2017.2 distribution.
QIIME 2 does not currently support Windows. We recommend using one of the QIIME 2 virtual machines.
Miniconda provides the
conda environment and package manager, and is the recommended way to install QIIME 2. Follow the 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.
After installing Miniconda and opening a new terminal, make sure you’re running the latest version of
conda update conda
Install QIIME 2 within a
Once you have Miniconda installed, create a
conda environment and install the QIIME 2 Core 2017.2 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-2017.2 to indicate what QIIME 2 release is installed (i.e.
The installation process differs slightly across platforms. Please choose the installation instructions that are appropriate for your platform.
macOS/OS X (64-bit)¶
conda create -n qiime2-2017.2 --file https://data.qiime2.org/distro/core/qiime2-2017.2-conda-osx-64.txt
conda create -n qiime2-2017.2 --file https://data.qiime2.org/distro/core/qiime2-2017.2-conda-linux-64.txt
If you receive errors during the installation process, such as
gfortran errors, please ensure you are following the installation instructions that are compatible with your platform.
Now that you have a QIIME 2 environment, activate it using the environment’s name:
source activate qiime2-2017.2
To deactivate an environment, run
If you plan to use the
q2-dada2 plugin that’s included in the Core distribution, you will need to install the latest version of dada2 through Bioconductor. Installing dada2 through Bioconductor is necessary because the latest version of dada2 is not available through
conda at the time of this writing. There is work being done to make the latest version of dada2 available through
conda. When the
conda package is available, these installation steps will no longer be necessary.
CDPATH= R -e 'source("https://bioconductor.org/biocLite.R"); biocLite("dada2")'
If installing dada2 via Bioconductor fails, try the following suggestions:
Per the Bioconductor installation instructions, try using
https://in the Bioconductor URL that is sourced above.
If you are using a Mac (i.e. macOS or OS X), install the Xcode Command Line Tools by running:
See this Apple technical note for more details and alternate ways of obtaining the Xcode Command Line Tools.
To test that dada2 installed correctly, run:
R -e 'library("dada2")'
If no errors are reported, 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.