# QIIME 2 2022.2 is now available!
**URL:** https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258
**Category:** Announcements
**Tags:** release
**Created:** [February 21, 2022, 11:56pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258 "2022-02-21T23:56:01Z")
**Posts on this page:** 14
**Page:** 1
### Author:  [@q2d2](https://forum.qiime2.org/u/q2d2)
#### Post date: [February 21, 2022, 11:56pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/1 "2022-02-21T23:56:01Z")
The QIIME 2 2022.2 release is now available! Thanks to everyone involved for their hard work!
As a reminder, our next planned QIIME 2 release is scheduled for April, 2022 (QIIME 2 2022.4), but please stay tuned for updates.
Check out the [QIIME 2 2022.2 docs](https://docs.qiime2.org/2022.2/) for details on installing the latest QIIME 2 release, as well as tutorials and other resources. Get in touch on the QIIME 2 Forum if you run into any issues!
Virtual machine builds will be available sometime this week (except for q2galaxy, its docker container is already published) - watch this topic thread for an update!
### New Documentation:
This release is timed with the release of several QIIME 2 documentation projects that provide new ways to learn QIIME 2 now, and a glimpse into where we're headed with QIIME 2 documentation in the future.
- We're excited to share a new multiple interface QIIME 2 tutorial, the [Cancer Microbiome Intervention](https://docs.qiime2.org/jupyterbooks/cancer-microbiome-intervention-tutorial/) tutorial. This tutorial derives from data from over 12,000 human-cancer-associated microbiome samples published in 2021 in [_Compilation of longitudinal microbiota data and hospitalome from hematopoietic cell transplantation patients_](https://www.nature.com/articles/s41597-021-00860-8). Users can choose whether to follow along using the QIIME 2 Galaxy Interface (which you can learn how to install [here](https://youtu.be/sdmhnKPR7G8)), the QIIME 2 command line interface, or the Python 3 API. This content is provided as a [JupyterBook](https://jupyterbook.org/intro.html), a documentation tool that you can expect to see a lot more of around the QIIME 2 ecosystem. π§
- [A new, free QIIME 2 YouTube course](https://youtube.com/playlist?list=PLbVDKwGpb3XmvnTrU40zHRT7NZWWVNUpt) that parallels the Cancer Microbiome Intervention tutorial. Over the next several months, we'll release new videos each week. This is our first video tutorial series that focused on the Galaxy interface, so if you want to learn to use QIIME 2 through Galaxy, this is a great place to start! @gregcaporaso provides a 3.5 minute introduction to the course [here](https://youtu.be/iqz1c2QhUD8). βΆ
- @gregcaporaso is sharing a preview of his QIIME 2 JupyterBook, [q2book](https://gregcaporaso.github.io/q2book/front-matter/preface.html). This is a work-in-progress, and not yet complete, but you can find useful background on [QIIME 2 archives (i.e., .qza and .qzv files)](https://gregcaporaso.github.io/q2book/using/getting-started.html#qiime-2-archives), [semantic types](https://gregcaporaso.github.io/q2book/using/getting-started.html#semantic-types-data-types-and-file-formats), [importing](https://gregcaporaso.github.io/q2book/using/importing.html), and more topics that will help you deepen your understanding of how QIIME 2 works and why. π
- Our Jupyter Book based tutorials (mentioned above), can be found on a new page in our user documentation, titled [_Jupyter Book Tutorials_](https://docs.qiime2.org/2022.2/jupyter-book-tutorials/). πππ
### Additional features:
- [QIIME 2 Framework](https://github.com/qiime2/qiime2)
- @ChrisKeefe made a handful of improvements/tweaks to Usage π
- @ebolyen fixed an inconsistency in the view\_type parameter of `Usage.import_from_format`, both string and classes are accepted as arguments now π₯
- Artifact API has now been renamed to the Python3 API πΊβ‘π
- [q2cli](https://github.com/qiime2/q2cli/)
- @ebolyen fixed a bug in the Usage driver which resulted in a namespace collision π
- @ebolyen fixed an issue where the incorrect usage variable was returned for `Usage.view_as_metadata` πͺ³
- [q2galaxy](https://github.com/qiime2/q2galaxy)
- When installing q2galaxy via the pre-built docker image, the conda environment is now already included. This results in a larger base image, but makes it far less likely that installation will fail. As a result, the first job will no longer take in excess of 40 minutes to complete πΎπππ±
- @ebolyen added a new Usage driver to automatically generate RST instructions for use within Galaxy tools and documentation π
- @ebolyen fixed an issue with string sanitization in the generated tools. (Unusual characters like `;` would be silently converted, breaking functionality.) π’π
- @ebolyen added a new template function to provide an automatically nested and alphabetized `tool_conf.xml` file. See `q2galaxy template tool-conf --help` πͺ
- [q2-sample-classifier](https://docs.qiime2.org/2022.2/plugins/available/sample-classifier/)
- @misialq added cross-validation to KNN sample classification based on distance matrices π£
- [q2-dada2](https://github.com/qiime2/q2-dada2)
- @sixvable added support for PacBio CCS data and @Keegan-Evans and @lizgehret added some final tweaks and tests + data. For more details be sure to checkout @benjjneb's [DADA2 paper](https://academic.oup.com/nar/article/47/18/e103/5527971?login=false) (and [datasets](https://github.com/benjjneb/LRASManuscript)!) that this is a wrapper for π
- [q2-longitudinal](https://github.com/qiime2/q2-longitudinal)
- @ebolyen added support for automatically quoting formula terms in `linear-mixed-effects`. Now column names like `my-category` will be quoted as `Q('my-category')` instead of raising an error. β
- [q2-mystery-stew](https://github.com/qiime2/q2-mystery-stew/)
- @ebolyen added more sophisticated metadata interactions. Now tests include `Usage.view_as_metadata` and `Usage.merge_metadata` π²
Happy QIIMEing! β π
---
### Author:  [@q2d2](https://forum.qiime2.org/u/q2d2)
#### Post date: [February 21, 2022, 11:57pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/2 "2022-02-21T23:57:57Z")
Docker images for q2galaxy are available now. See installation [instructions](https://github.com/qiime2/q2galaxy#docker-1) and [video](https://youtu.be/sdmhnKPR7G8).
---
### Author:  [@q2d2](https://forum.qiime2.org/u/q2d2)
#### Post date: [February 24, 2022, 7:27pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/4 "2022-02-24T19:27:07Z")
Hi folks! The moment you've been waiting for has arrived! π₯³ QIIME 2 virtual machines are now available! π» π
---
### Author:  [@ebolyen](https://forum.qiime2.org/u/ebolyen)
#### Post date: [April 8, 2022, 11:45pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/5 "2022-04-08T23:45:11Z")
Minor update:
A few OS-X dependencies were moved around and resulted in conda no longer resolving packages on OS-X. We've update the environment files to reflect the new dependencies and everything seems to be working as expected now. We've also re-solved the dependencies on linux as well to keep things consistent.
If you've been having issues installing this release on OS-X, delete your current environment file (`qiime2-2022.2-py38-osx-conda.yml`) and start the installation over by downloading the (now-updated) environment file.
If you have not had this issue, then no worries, there's nothing particularly notable about the dependency updates, and we are not aware of any related bugs impacting QIIME 2. This means you don't need to do anything if you already have a working install.
For the curious, [here's how the dependencies were updated](https://github.com/qiime2/environment-files/pull/13/files).
---
### Author:  [@Roddyjocif](https://forum.qiime2.org/u/Roddyjocif)
#### Post date: [May 15, 2022, 10:37pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/6 "2022-05-15T22:37:52Z")
Hi guys, I am having some problems trying to update my VirtualBox to the qiime 2022.2.
When downloading the qiime 2022.2 image following the link "[https://data.qiime2.org/distro/core/2022.2](https://data.qiime2.org/distro/core/2022.2)" (as recommended at "[https://s3-us-west-2.amazonaws.com/qiime2-data/distro/core/virtualbox-images.txt](https://s3-us-west-2.amazonaws.com/qiime2-data/distro/core/virtualbox-images.txt)"), I get all I would need to install the previous image, the downloaded fileΒ΄s name is "QIIME 2 Core - 2021.11 (1638916567)". Maybe an amazon issue? is there any other way to obtain the qiime 2022.2 image for VirtualBox?
Thank you for making all these tools available for all =)
Best regards.
Roddy
---
### Author:  [@Keegan-Evans](https://forum.qiime2.org/u/Keegan-Evans)
#### Post date: [May 16, 2022, 4:24pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/10 "2022-05-16T16:24:58Z")
@Roddyjocif,
We have a patch for the release that we are finishing up this week, as soon as all of the files are ready for it, I will build a new Vbox image and let you know when it is ready!
---
### Author:  [@Keegan-Evans](https://forum.qiime2.org/u/Keegan-Evans)
#### Post date: [May 16, 2022, 4:44pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/14 "2022-05-16T16:44:26Z")
@Roddyjocif,
Just to be clear, there is nothing you were doing wrong, the Virtual Box image that is available is the wrong one, but we will be uploading the correct one soon!
---
### Author:  [@Roddyjocif](https://forum.qiime2.org/u/Roddyjocif)
#### Post date: [May 16, 2022, 11:53pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/15 "2022-05-16T23:53:30Z")
Thanks a million @Keegan-Evans !
Best of lucks.
---
### Author:  [@thermokarst](https://forum.qiime2.org/u/thermokarst)
#### Post date: [May 18, 2022, 4:04pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/16 "2022-05-18T16:04:52Z")
---
### Author:  [@lizgehret](https://forum.qiime2.org/u/lizgehret)
#### Post date: [June 2, 2022, 10:49pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/17 "2022-06-02T22:49:45Z")
Hi @Roddyjocif,
Thanks for your patience! The new Virtual Box image has just been uploaded, so you should be all set to download that latest image at your convenience. Happy :qiime2:ing! π
---
### Author:  [@lizgehret](https://forum.qiime2.org/u/lizgehret)
#### Post date: [June 2, 2022, 10:49pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/18 "2022-06-02T22:49:51Z")
---
### Author:  [@thermokarst](https://forum.qiime2.org/u/thermokarst)
#### Post date: [June 3, 2022, 1:13am UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/19 "2022-06-03T01:13:25Z")
---
### Author:  [@q2d2](https://forum.qiime2.org/u/q2d2)
#### Post date: [June 3, 2022, 4:31pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/21 "2022-06-03T16:31:30Z")
Hi all, we have released a few minor patch updates this week for the 2022.2 release.
- QIIME 2 Framework: @ebolyen added support for alternative "missing" metadata schemas. We plan on providing new docs and/or tutorials for this in future releases.
- q2-diversity: @yoshiki exposed the option to subsample with replacement when running the `core-metrics-phylogenetic` pipeline.
- q2-diversity-lib: @thermokarst fixed a bug introduced in newer versions of `unifrac` that caused certain diversity metric computations to allocate 100% of the host's CPUs.
Also, as @lizgehret mentioned above, she has prepared all new VMs that include these patches - you can check out the latest AWS, Docker, and VirtualBox images here:
[https://docs.qiime2.org/2022.2/install/virtual/](https://docs.qiime2.org/2022.2/install/virtual/)
**These will be the final AWS and VirtualBox images that the QIIME 2 team provides** - we will continue to support conda ("native") and docker installation methods. Thanks!
> [@q2d2](#):
>
> As a reminder, our next planned QIIME 2 release is scheduled for April, 2022 (QIIME 2 2022.4), but please stay tuned for updates.
Regarding the proposed 2022.4 release - we decided to issue this small patch release in lieu of a full-blown 2022.4 release, and we are still planning on when our next full release will occur, but probably some time in the next ~2 months.
Happy QIIMEing!
---
### Author:  [@thermokarst](https://forum.qiime2.org/u/thermokarst)
#### Post date: [June 3, 2022, 4:31pm UTC](https://forum.qiime2.org/t/qiime-2-2022-2-is-now-available/22258/22 "2022-06-03T16:31:58Z")