Help! I’m using Windows¶
Nextstrain documentation assumes users are running a Unix-based system like macOS or Linux. It is in theory possible to install and run Nextstrain components in Windows natively, but it will be less straightforward and won’t be covered here.
However, a new feature in Windows 10 means you can easily run a ‘subsystem’ of Linux on your Windows machine, ensuring you’ll be able to use exactly the same commands as given in the documentation.
After installing, you may want to Google for some information (or a tutorial) on basic Linux commands. This guide will assume you’re relatively new to Linux/Ubuntu; if you’re a more advanced user can modify the instructions to suit your preferences.
Enable and Install Ubuntu via Microsoft Store¶
The Windows Subsystem for Linux is developed and supported by Microsoft, so it will not cause any problems for your computer. It is not a ‘dual-boot’ system, where you must restart to switch between Windows and Ubuntu; you’ll be able to run Ubuntu in a window within Windows. Though multiple Linux distributions are now available, we recommend installing Ubuntu, as it has lots of support available online for Windows 10 installations.
Follow these instructions to install Windows Subsystem for Linux, and select ‘Ubuntu’ from the Store. Be sure to follow the instructions for ‘initialization of your distro’, and update/upgrade Ubuntu using
sudo apt update && sudo apt upgrade
Take note of your password; you’ll need this whenever you run
sudo commands (like running ‘as administrator’ in Windows).
Miniconda allows you to create ‘environments’ within Ubuntu and more easily install some packages. We’ll do this to make the installation of some Nextstrain components easier.
Download the latest Python 3.6 Linux version of Miniconda. You may want to move the download to inside the folder your symlink leads to, to make it easier to navigate to the file location within Ubuntu.
Once inside the folder with the file you downloaded, type
bash followed by the name of the file you downloaded. For example:
Follow the prompts and accept the defaults if you are unsure. You’ll need to close and re-open your Ubuntu window to finish the installation.
After re-opening Ubuntu, you can type
conda list to ensure it’s installed correctly.
Note that you’ll always need to open an Ubuntu window and use
conda activate nextstrain before running any of the Nextstrain programs like
Never modify your Ubuntu system files (like
.bashrc) in Windows!
Use an editor within Ubuntu, like