diff --git a/docs/.howto b/docs/.howto
--- a/docs/.howto
+++ b/docs/.howto
@@ -3,4 +3,4 @@
 # docker build --tag sphinx-doc-build-rc .
 
 # Build Docs
-# docker run --rm -v $(PWD):/project --workdir=/project/docs sphinx-doc-build-rc make clean html
\ No newline at end of file
+# cd && docker run --rm -v $(pwd):/project --workdir=/project/docs sphinx-doc-build-rc make clean html
\ No newline at end of file
diff --git a/docs/install/migrate-repos.rst b/docs/install/migrate-repos.rst
--- a/docs/install/migrate-repos.rst
+++ b/docs/install/migrate-repos.rst
@@ -2,22 +2,24 @@
 
 Migrating |repos|
 -----------------
-
-If you have installed |RCE| and have |repos| that you wish to migrate into
-the system, use the following instructions.
+When you install |RCE| you will be presented with 2 choices:
 
-1. On the |RCE| interface, check your |repo| storage location under
-   :menuselection:`Admin --> Settings --> System Info`. For example,
-   Storage location: /home/{username}/repos.
+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.
 
-2. Copy the |repos| that you want |RCE| to manage to this location.
-3. Remap and rescan the |repos|, see :ref:`remap-rescan`
 
 .. important::
+    Repo storage path inside docker is configurable in ``rhodecode.ini`` file:
+    ``repo_store.path = /var/opt/rhodecode_repo_store``
 
-   Directories create |repo| groups inside |RCE|.
+    Mounting of local filesystem folder is configurable in ``docker-compose-apps.override.yaml``
+
+    Importing adds |RCE| git hooks to your |repos|.
 
-   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.
 
-   You should verify if custom ``.hg`` or ``.hgrc`` files inside
-   repositories should be adjusted since |RCE| reads the content of them.
+.. note::
+    Theres 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``)