.. _manually-vcsserver-ini:

Change |VCS| Settings
=====================

If you need to manually configure the |VCS| settings on a |RCEE| instance,
use the following steps. If you have not installed a |VCS|,
see :ref:`install-vcsserver`.

Link a |VCS| to |RCEE|
----------------------

To configure a |RCEE| instance to use a |VCS|, use the following steps:

1. Find the information of the specific |VCS|

.. code-block:: bash

    $ rccontrol status

     - NAME: enterprise-1
     - STATUS: RUNNING
     - TYPE: Enterprise
     - VERSION: 3.5.0
     - VCS: None
     - URL: http://127.0.0.1:10001

     - NAME: vcsserver-1
     - STATUS: RUNNING
     - TYPE: VCSServer
     - VERSION: 3.5.0
     - URL: http://127.0.0.1:10000

2. Open the :file:`rhodecode.ini` file for that particular instance.
   The default location is
   ``/home/<user>/.rccontrol/<instance-id>/rhodecode.ini``

3. Set the ``vcs.server`` property to match those of your running |VCS|.

.. code-block:: ini

    ##################
    ### VCS CONFIG ###
    ##################
    vcs.server.enable = true
    vcs.server = 127.0.0.1:10000
    vcs.server.log_level = info
    vcs.start_server = false
    vcs.backends = hg, git, svn
    vcs.connection_timeout = 3600

4. Save the file and restart the |RCEE| instance to pick-up the changes

.. code-block:: bash

    $ rccontrol restart enterprise-1
    Stopping instance: enterprise-1
    Starting instance: enterprise-1

5. See that the |RCEE| instance is linked to the right |VCS| server

.. code-block:: bash

    $ rccontrol status

     - NAME: enterprise-1
     - STATUS: RUNNING
     - TYPE: Enterprise
     - VERSION: 3.5.0
     - VCS: vcsserver-1
     - URL: http://127.0.0.1:10001

     - NAME: vcsserver-1
     - STATUS: RUNNING
     - TYPE: VCSServer
     - VERSION: 3.5.0
     - URL: http://127.0.0.1:10000