The distribution packages for McStas may be downloaded via

McStas 2.1 and later on Unix - from source code

In principle any Unix/Linux distribution should be able to run McStas, but we specifically support Debian (.deb) and RedHat (.rpm) binary-package based distributions - see

In case your Unix is not Debian or RedHat like, you should still be able to build either from the source tarball or directly from GitHub. Both methods are examplified below:

Tarball Installation on FreeBSD (tested on PC-BSD 10.0)

For the other McStas tool packages, please inspire from the dependencies listed in our BUILD_DEPS.TXT document.

Building from GitHub

- check out a copy via
git clone

We build using CMake - which needs to be above version 3.0!

Most of the build dependencies are listed in the file BUILD_DEPS.TXT which is also located in your checked-out folder.

Also top level in that folder you will find a set of helper scripts called build_* which we use to build for e.g. Debian, RedHat, Windows and Mac OS X The script build_src_bin_mcstas should (via common Linux "settings" in the cmake "toolchains" cmake/toolchains/linux*) be able to build most of the packages as .tar.gz bundles.

Each of the sub-packages can also be built directly from the individual folders using a more or less standard CMake approach, e.g.:

The most important settings for cmake building are

Please report any trouble in using these instructions to

Last modified: Thu Jun 16 10:49:39 CEST 2016