Skip to content

Installation of precompiled packages

J-Donald Tournier edited this page Sep 16, 2019 · 3 revisions

MRtrix3 now provides pre-compiled versions for installation on Windows and macOS. Detailed instructions are provided below.

Microsoft Windows

  1. Download and install the 64-bit version of MSYS2, available from the MSYS2 homepage. This provides all the dependencies required for MRtrix3 to run, along with a Unix-like command-line environment.

  2. Open the 'MSYS2 MinGW 64-bit' application, which should open a terminal window. You should find this in your start menu, within the 'MSYS2 64bit' application folder. Make sure to use the 64-bit MinGW version, not either of the other other options - otherwise MRtrix3 will simply not run.

  3. Bring your MSYS2 installation up to date, as instructed on the MSYS2 homepage. This typically involves typing:

    pacman -Syu

    Note that you may need to type this in several times (closing the terminal as instructed each time), until the command reports that it is up to date.

  4. download and install the MSYS2 MRtrix3 package using the pacman package manager provided by MSYS2. This will also install all required dependencies (warning: this is a big download). This can be achieved by copying the following commands into the 'MSYS2 MinGW 64-bit' terminal window:

    pacman -U mingw-w64-x86_64-mrtrix3-3.0_RC3_latest-1-x86_64.pkg.tar.xz
  5. Check your installation by typing mrview at the terminal.


  1. Open the Terminal application

  2. Download & extract the macOS package, and finalise the install with the following commands:

    tar xfz macOS-mrtrix3-3.0_RC3_latest.tar.gz
    cd mrtrix3
  3. Close the terminal, open a new Terminal window, and verify your install by typing mrview in the new terminal window.

Clone this wiki locally
You can’t perform that action at this time.