General advice

If something goes wrong when running CMake please try again with an empty or newly created build-directory! This is the very first thing you should try!

Please read the CMake output carefully. Often it will tell you what went wrong.

Also consider using the command line for CMake configuration as lots of CMake options (which modify requirements on third-party libraries) have to be set via the command line before CMake ran for the first time. E.g. when building with PETSc the following fails:

  • Creating build directory
  • Starting CMake GUI
  • Click Configure
  • Enable option OGS_USE_PETSC

When clicking Configure, CMake runs without OGS_USE_PETSC enabled and picks a VTK library which is not compiled for MPI usage. The picked VTK library is cached and never modified. When enabling PETSc it still uses the old (and now wrong) VTK library.

Instead you should use the CMake command line:

mkdir build
cd build
cmake ../ogs -DOGS_USE_PETSC=ON

The following options are affected by this behavior and should not be changed after initially set (this means do not use ccmake or CMake-GUI for the first CMake run):


Check also Conans troubleshooting page if you use Conan for dependencies.

This article was written by Lars Bilke. If you are missing something or you find an error please let us know.
Generated with Hugo 0.117.0 in CI job 362666 | Last revision: July 12, 2023
Commit: [PL/SSD] Rename x_dot to x_prev 04a8fec8  | Edit this page on