Chapter 1.  Getting Started

Geant4 uses CMake to configure a build system for compiling and installing the toolkit headers, libraries and support tools. This document covers the basics of using CMake to build and install Geant4 together with an overview of the most commonly used advanced features. We also provide a basic overview of how to build an application that uses Geant4. For more information on CMake itself, the CMake Help and Documentation should be consulted.

1.1.  Supported and Tested Platforms

Geant4 is officially supported on the following operating system and compiler combinations:

  • Scientific Linux CERN 6 with gcc 4.8.X, 4.9.X, 64bit

    GCC 4.8.X may be installed on SLC6 systems via the free Developer Toolset .

    Geant4 has also been successfully compiled on other Linux distributions, including Debian, Ubuntu and openSUSE. Please note that distributions other than SLC are not officially supported. However, we welcome feedback and patches for non-SLC platforms!

  • Mac OS X 10.9 (Mavericks) with Clang 3.5 (Apple-LLVM 6.0), 64bit.

    Geant4 has also been successfully compiled on Mac OS X 10.7 (Lion) with Clang 3.2 (Apple), and 10.8 (Mountain Lion) with Clang 3.4 (Apple) but these versions of Mac OS X are not officially supported. Please note that Mac OS X 10.10 (Yosemite) is not officially supported or tested in the initial release. Geant4 has been successfully installed and applications built and run against it on Yosemite, and official testing and support is expected in subsequent patches.

  • Windows 7 with Visual Studio 12 (VS2013).

    Multithreading of Geant4 is currently not supported on the Windows platform.

The Geant4 toolkit and applications can also be compiled for Intel Xeon Phi systems. Though we cannot offer full support for this architecture, a guide discussing our current experience with the platform is available separately.

The following platforms and compilers are also tested, but not officially supported:

  • Scientific Linux CERN 6 with gcc 4.4.X, 4.7.X.

    Scientific Linux CERN 6 with Intel 14.X.

  • Ubuntu Linux 14 with gcc 4.8.
  • Mac OS X 10.8 (Mountain Lion) Clang 3.4.
  • Windows 7 with Visual Studio 9 (VS2008) (single threaded only).

We welcome user feedback and/or bug reports via our HyperNews Forum and Bugzilla.