Skip to content

Pre installation: Linux distribution packages

Yvan Fournier edited this page Sep 10, 2025 · 9 revisions

Recommended pre-requisites are described in detail in the installation documentation, but since some packages and names vary across Linux distributions. Here is an attempt to list recommended prerequisite packages, on a "per-distribution basis."

Arch Linux

Base packages

For the installation of a .tar.gz release, the following packages should be installed first:

gcc gcc-fortran openmpi python-pyqt5 zlib

The hdf5 and cgns packages can be used, but MED 4.1 is not compatible with HDF5 1.12, so if that is needed, building a HFD5-1.10 version (either manually or using code_saturne's semi-automatic installer) is recommended. This implies building CGNS also with than same base if that library is desired.

For installation from git clone or development

The following packages will be needed for the "bootstrap" phase, needed for new git clones or when the source tree has been modified:

autoconf automake

For generation of documentation

Generating the documentation requires:

doxygen graphviz texlive-science

For installation of ParaView Catalyst

This will require the installation of a Python and MPI-enabled Parawiew. If you choose to install a separate version based on OSMesa (off-screen Mesa), the mesa package can be used. Ray-tracing will require the ospray package.

In any case, cmake will be useful.

Debian GNU/Linux and Ubuntu

Base packages

For the installation of a .tar.gz release, the following packages should be installed first:

gcc g++ gfortran openmpi-bin pyqt5-dev pyqt5-dev-tools python3-pyqt5 python3-setuptools zlib1g-dev

The libhdf5-dev package can be used as a prerequisite for installation of the CGNS and MED libraries, though the semi-automatic installer can also build and install a version aligned with MED, which will only build with a matching hdf5 series (hdf5-1.12 for MED 5.0, 5.10 for MED 4.1).

For installation from git clone or development

The following packages will be needed for the "bootstrap" phase, needed for new git clones or when the source tree has been modified:

autoconf automake autotools

For generation of documentation

Generating the documentation requires:

doxygen graphviz texlive-science

For installation of ParaView Catalyst

This will require the installation of a Python and MPI-enabled Parawiew. If you choose to install a separate version based on OSMesa (off-screen Mesa), the libosmesa6-dev package can be used. In any case, cmake will be useful.

Possible issue on Windows Subsystem for Linux

Some users have reported issues detecting/loading PyQt on WSL-based Debian, Ubuntu, or Arch Linux systems. This is a known issue

For this, the workaround seems to be to run:

sudo strip --remove-section=.note.ABI-tag /usr/lib/x86_64-linux-gnu/libQt5Core.so.5

Or

sudo strip --remove-section=.note.ABI-tag /usr/lib64/libQt5Core.so.5

depending on the libQt5Core.so.5 installation path.