# Software requirements
## Operating system
Recommended operating system is Red Hat Enterprise Linux (RHEL) / Rocky Linux versions 8 or 9.
For this operating systems we provide RPMs with pre-built binaries to simplify deployment.
On experimental basis we also build repositories for Ubuntu 22.04 and 24.04.

Running Jungfraujoch on Red Hat Enterprise Linux 7 is currently not tested and not recommended,
but likely possible with providing some packages from external repositories.

Two programs additionally run on **Windows 11**: the desktop viewer `jfjoch_viewer`, shipped as a
pre-built installer, and [`rugnux`](RUGNUX.md), the offline analysis CLI, shipped as a `.zip`. Both
can be built from source with Visual Studio 2026 (MSVC) and CUDA 13.3 — the viewer additionally
needs Qt 6.11; see
[jfjoch_viewer ▸ Building from source on Windows](JFJOCH_VIEWER.md#building-from-source-on-windows).
The Windows artefacts bundle the Qt runtime (viewer only) and, on the CUDA builds, the cuFFT DLL, so
end users need neither Qt nor a CUDA toolkit installed — only an NVIDIA GPU driver for the GPU path.
On Linux the portable archives link CUDA entirely statically and so need nothing but the driver.
`rugnux` is also built for **64-bit Arm Linux** (GH200, DGX Spark). The rest of Jungfraujoch is
Linux-only and x86-64-only. See [Release contents](RELEASE_CONTENTS.md) for the CPU baseline and
CUDA requirements of each released package.


## Software dependencies
Required:
* C++20 compiler and C++20 standard library; recommended GCC 11+ or clang 14+ (Intel OneAPI, AMD AOCC)
* CMake version 3.26 or newer + a build tool (GNU make or Ninja)
* zlib compression library
* Eigen (header-only linear algebra library), version 3.4.x (the build requests `Eigen3 3.4`, which
  Eigen's same-major-version rule does not satisfy with 5.x)

HDF5, libtiff and libjpeg-turbo used to be required system packages; they are now downloaded and
built automatically by CMake (see the note below), so they no longer need to be installed.

Optional:
* CUDA compiler version 12.8 or newer - required for the MX fast feedback indexer and GPU analysis
* FFTW library - for indexing if GPU/CUDA is absent (also auto-downloaded by CMake)
* Node.js - to build the frontend
* Qt version 6 (for jfjoch_viewer)

Many further dependencies (spdlog, Zstandard, HDF5, slsDetectorPackage, libzmq, libtiff,
libjpeg-turbo, Ceres, the fast feedback indexer, Catch2, ...) are downloaded automatically
by CMake and statically linked; building therefore requires network access on the first configure.
zlib and Eigen are the exception — they must be preinstalled (found via `find_package`); on Windows,
where they are not present system-wide, install them into a prefix and point `CMAKE_PREFIX_PATH` at
it (see [Building from source on Windows](JFJOCH_VIEWER.md#building-from-source-on-windows)).
Others are vendored directly in the source tree. The complete list of third-party components, with
copyright holders, licenses and verbatim license texts, is in
[Third-party software notices](THIRD_PARTY_NOTICES.md) and the `licenses/` directory.