.. _config-files:

Configuration Files Overview
============================

|RCE| and |RCC| have a number of different configuration files. The following
is a brief explanation of each, and links to their associated configuration
sections.

.. rst-class:: dl-horizontal

    \- **rhodecode.ini**
        Default location:
        :file:`config/_shared/rhodecode.ini`

        This is the main |RCE| configuration file and controls much of its
        default behaviour. It is also used to configure certain customer
        settings. Here are some of the most common reasons to make changes to
        this file.

        * :ref:`config-database`
        * :ref:`set-up-mail`
        * :ref:`increase-gunicorn`
        * :ref:`x-frame`

    \- **search_mapping.ini**
        Default location:
        :file:`/home/{user}/.rccontrol/{instance-id}/search_mapping.ini`

        This file is used to control the |RCE| indexer. It comes configured
        to index your instance. To change the default configuration, see
        :ref:`advanced-indexing`.

    \- **vcsserver.ini**
        Default location:
        :file:`config/_shared/vcsserver.ini`

        The VCS Server handles the connection between your |repos| and |RCE|.
        See the :ref:`vcs-server` section for configuration options and more
        detailed information.

    \- **.rhoderc**
        Default location: :file:`/home/{user}/.rhoderc`

        This file is used by the |RCE| API when accessing an instance from a
        remote machine. The API checks this file for connection and
        authentication details. For more details, see the :ref:`config-rhoderc`
        section.
