Installation how-to

Which packages are available?

The FLUKA Monte Carlo code is written in the FORTRAN77 programming language. A recent gcc/gfortran compiler version (>= 7) is needed for installing and running the code. The code is distributed in the form of:

  1. a set of precompiled libraries for x86_64 (64 bit) platforms with GNU/Linux or macOS operating systems (available to all registered users),
  2. the source code (available to affiliates of institutes/universities holding an institutional FLUKA licence, and to CERN Staff and Fellows, see licences.).

In the latter case, FLUKA can be built from source and it is not necessary to download the libraries. All packages contain also the FLUKA user routines, include files, post-processing programs etc. (see FLUKA package file structure for details). Note that the file structure has been changed as of release 2011-3.0 (Dec 2019).

Installing precompiled libraries on GNU/Linux and macOS

The precompiled libraries are distributed in the following package formats:

Builds with different gfortran versions are distributed in the download area. The following table illustrates which build version shall be used depending on the gfortran compiler installed on your system:

OS Build version available in the download area: Works with following compiler version on your machine:
GNU/Linux gfortran 7.5 gfortran 7.x
GNU/Linux gfortran 9.3 gfortran 8.x, 9.x, 10.x
macOS gfortran 8.4 gfortran 8.x
macOS gfortran 10.1 gfortran 9.x, 10.x

For installing FLUKA on CERN lxplus machines see also following installation instructions.

The code has been checked and validated only for these platforms/compilers. FLUKA builds with the g77 compiler, which have been available for previous FLUKA versions, are currently not distributed. Users who are in urgent need of a g77-built FLUKA library are kindly asked to submit a special request using the contact form.

Building FLUKA from source on GNU/Linux and macOS

The source code is distributed in the following package formats:

Users are strongly encouraged to build FLUKA only on architectures and with compilers recommended by the development team:

  • GNU/Linux: gcc/gfortran 7.x, 8.x, 9.x, 10.x
  • macOS: gcc/gfortran 8.x, 9.x, 10.x

Only results obtained with code versions on these platforms and compilers shall be used for critical applications.

Running FLUKA on Windows systems

On Windows 10, the Windows subsystem for Linux (WSL) can be used for running FLUKA (and Flair). WSL allows developers to run a GNU/Linux environment under Windows without the overhead of a virtual machine (see link). Detailed instructions for using FLUKA and Flair under WSL can be found here.

On Windows 7, 8 or older builds for Windows 10, WSL is not available. In this case one can use Vagrant. The instructions can be found here.