.. _config-user:

*************
Configuration
*************

The ``esmvaltool`` command is provided by the ESMValCore package, the
documentation on configuring ESMValCore can be found
:ref:`here <esmvalcore:config>`.
In particular, it is recommended to read the section on the
:ref:`User configuration file <esmvalcore:user configuration file>`
and the section on
:ref:`Finding data <esmvalcore:findingdata>`.

To install the default configuration file in the default location, run

 .. code:: bash

	  esmvaltool config get_config_user

Note that this file needs to be customized using the instructions above, so
the ``esmvaltool`` command can find the data on your system, before it can run
a recipe.

There is a lesson available in the
`ESMValTool tutorial <https://tutorial.esmvaltool.org/>`_
that describes how to personalize the configuration file. It can be found
`at this site <https://tutorial.esmvaltool.org/03-configuration/index.html>`_.