This page describes errors you get at runtime of OGS, e.g. when executing the ogs-executable or some utilities.

Error message: error while loading shared libraries / XX.dll could not be found or could not be found.

Linux / macOS

Typical error message:

error while loading shared libraries: cannot open shared object file: No such file or directory

A shared library which was linked to OGS could not be found during runtime. The runtime search paths are determined by the system configuration but you add paths with the environment variable LD_LIBRARY_PATH (macOS: DYLD_LIBRARY_PATH). If you know where the missing library is located you can adapt the environment variable:

export LD_LIBRARY_PATH=/path/to/missing/lib:$LD_LIBRARY_PATH

More information can be found here:

If you use Conan you want to activate its runtime environment.

One can see with the ldd (macOS: otool -L) tool which dynamic libraries will be loaded at runtime.


Typical error message:

XX.dll could not be found.

Similar to Linux but on Windows you need to adapt the PATH environment variable.

One can use the Dependencies-tool to see which DLLs will be loaded at runtime.

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 387530 | Last revision: November 7, 2023
Commit: [PL/HM] clang-format 7e2f7b3  | Edit this page on