QIIME 2 Core Distribution Builds
We are pleased to announce the release of several new core distribution builds for QIIME 2! If you are interested in experimenting with QIIME 2 these options can get you from zero to QIIME 2 in no time! We currently support the QIIME 2 2.0.6 release cycle, including all of the core plugins, in the following formats:
- Amazon Web Services EC2 AMI Images
- Virtualbox VMDK Images
- Docker Images
The core plugins included are:
- Set up Virtualbox on your computer (see virtualbox.org for details).
- Download the QIIME 2 Core Virtualbox Image here: https://data.qiime2.org/distro/core/qiime206.zip.
- Unzip the
- Launch VirtualBox, and create a new machine (press the New button)
- A new window will show up. Click ‘Next’
- In this screen type QIIME 2 Core 2.0.6 as the name for the virtual machine then select Linux as the Operating System, and Ubuntu (64 bit) as the version. Click Next.
- Select the amount of RAM (memory). You will need at least 2048 MB, but the best option is based on your machine. After selecting the amount of RAM, click Next.
- Select “Use existing hard drive”, and click the folder icon next to the selector (it has a green up arrow). In the new window click ‘Add’, and locate the virtual hard drive that was unzipped in step 3. Click Select and then click Next.
- In the new window click Finish.
- Launch the virtual machine. When prompted, select the user
qiime2, and enter the password
Amazon Web Services Quickstart
- Set up an Amazon Web Services (AWS) account, and log in.
- Set your region to “US West (Oregon)”.
- When launching an instance, select “Community AMIs”, and search for “QIIME 2 Core” (the AMI ID is
- When prompted to set up a security group, make sure that port 22 is open.
- When prompted to set up an SSH keypair, choose “Proceed without a keypair”.
- Once the machine has finished booting, you can SSH into the machine using:
$ ssh qiime2@<PUBLIC_AWS_IP_ADDRESS>
# When prompted, provide the password `qiime2`
- Set up Docker on your computer (see docker.com for details).
- In a terminal with Docker activated, run
docker pull qiime2/core:latest.
docker run -t -i -v $(pwd):/data qiime2/core qiime to confirm that the image was successfully fetched.
Future distribution builds
At this stage we’re unsure of what types of builds we’ll continue to release in the future. We expect that for at least the next few QIIME 2 releases we’ll provide the three builds included here, but we may ultimately phase out the AWS and VirtualBox builds. This is because our release of these builds restricts users to a specific operating system/cloud platform/etc, so we feel that we may better serve our user community by providing cross-platform builds (e.g., Docker containers) and detailed instructions for how to work with these.