.. _mig-repos:

Migrating |repos|
-----------------
When you install |RCE| you will be presented with 2 choices:

1. Mount existing folder on your local filesystem, and this is what |RCE| will use to store your repos. In this case |RCE| will automatically import repos present in that folder. You can also do :ref:`remap-rescan` from admin interface to force new repos discovery.
2. Use docker named volume ``rc_reposvolume`` - in this case you can either set create new |repo| in |RCE| UI and set it as a remote for your local repo, and then push. If your repo is hosted somewhere else, click "Import Existing Repository ?" and provide url to it. |RCE| will attempt to pull it and import.


.. important::
    Repo storage path inside docker is configurable in ``rhodecode.ini`` file:
    ``repo_store.path = /var/opt/rhodecode_repo_store``

    Mounting of local filesystem folder is configurable in ``docker-compose-apps.override.yaml``

    Importing adds |RCE| git hooks to your |repos|.

    You should verify if custom ``.hg`` or ``.hgrc`` files inside
    repositories should be adjusted since |RCE| reads the content of them.

.. note::
    There's another override file for dev setup, which mounts default workspace folder as a repo storage by default.
    you can configure this by changing ``docker-compose-apps.dev.yaml``
    (and commenting out all lines ``$WORKSPACE_HOME:/var/opt/rhodecode_repo_store:delegated``)
