preCICE needs to be configured at runtime via an `xml` file, typically named `precice-config.xml`. Here, you specify which solvers participate in the coupled simulation, which coupling data values they exchange, which numerical methods are used for the data mapping and the fixed-point acceleration and many other things. On this page, we give you an overview of the complete configuration section of the documentation.

You are new to preCICE and want to learn how the configuration works?

Have first a look at the introduction page. Here, we explain in which basic sections the configuration is structured and how the different sections are connected. Afterwards you can study the details of the main parts:

And some optional advanced parts:


You are already familiar with the preCICE configuration, but you don’t remember how a certain option was called?

Then you should look at the configuration reference. Also simply try the search here on top. The configuration reference is up to date with the last release of preCICE. If you need an older version, you can always generate this documentation yourself:

./binprecice md > reference.md

There is also an xml variant of the reference. Just call binprecice without arguments to see all options.


You want to port your configuration file from preCICE v1.x to v2.x?

There is a seperate page with all steps required for porting.