Qiime2 on Windows Subsystem for Linux

[Francisco (Francisco Cárdenas)]

[NOTE: This tutorial was written using Qiime2 2019.10 and windows 10 version 1909 or "May Update". Instruccions may be the same but some links not.]

Hi guys, actually im working with qiime2 on WSL but cant find a "tutorial" to install it, i know its simple but for someone new could be nice to find this kind of info.

First install Linux on windows (Windows Subsystem for Linux or WSL ahead from here)

Open Windows Power Shell in Admin Mode and type in the console:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

This allow the computer to install the WSL, then restart your computer and from the Windows store install your desired Linux distro or just Ubuntu, then open it to finish the installation.

Now proceed to download miniconda with command wget:
(If your distro don't have wget, type: $ conda install wget)

NOTE: This miniconda link is old, go to the miniconda page and get the latest link version

example: wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh (the link may vary)

we can get the link from the miniconda page, right click on the version you wish to download and then copy link

Once donwloaded the file, install it with command bash:

example: bash Miniconda3-latest-Linux-x86_64.sh (the file may vary)

just follow the instructions that appear in the console.

With everything prepared, we must get Qiime2, just need to follow the instructions in the Qiime2 Page.

https://docs.qiime2.org/2019.10/install/native/

NOTE: This link takes to an old Qiime2 version, please refer to the latest or desired Qiime2 version, and use the "Native" installation.

Once installed, we need a "share folder" between WSL and W10, it is not recommended to just enter to the WSL files and drag wat whe want, so...

In our WSL console, create a folder or directory (for example directory named sharew), once inside this directory type:

explorer.exe .

its important to not avoid the space and point at the end, this command opens the Windows explorer in the location typed (directory sharew), we can get this directory into "rapid acces" for an easy file share between w10 and our WSL, with this, we have everything ready to work!

IMPORTANT: ALWAYS open your WSL console before manipulating your shared directory / folder (no need to enter in to the folder in the console, just have it open).

comments and gramatic corrections are welcome

[SonWende]

Hey, many thanks for this description!

Can I ask how you handle visualizations?

Since i want to avoid installing a VM, i am also using qiime2 on WSL. But i haven’t really found a comfortable solution for using visualizations from WSL. Sharing the .qzv files to window works of course, but if possible i would like to use the command qiime tools view somefile.qzv from WSL.
I have an Xserver and Xming set up and can run GUI apps from WSL, but this command does not connect.

Anyone any Ideas?

Thanks in advance

[Francisco (Francisco Cárdenas)]

I use the shared folder to acces the files and visualizate them on Windows, i havent find a way to visualizate them directly on WSL, all i can find Is the Xserver and Xming option. If you find a solution could you share It here? ill be looking for one too.

but @SonWende why u want to visualize directly on WSL? i find really practical to just open the shared folder and drag the qzv files to the qiime visualizer

[gaolei]

Hello,thanks for your share.
Could you please repost a instruction with some operational pictures?
I can’t understand how do you create a share folder especially.

[Francisco (Francisco Cárdenas)]

Like this one?
Creating the share folder isn’t that hard

Open your WSL (linux on windows), create a share folder where you want it
(in the picture the example folder is “sharew”)

Then I opened sharew directory and created a .txt file named hi and then ejecuted explorer.exe . <---- inside sharew folder!! that command opens the windows explorer like in the picture, once open you should be able to see the .txt file and just create a “quick acces” to that file.

Pic added to he main post!