diff --git a/doc/linux.rst b/doc/linux.rst
index 38ee9185c738c28fb46905334909081ad78f20b4..ce772437fbaf5e00ad5f044f8dc67932adaf3349 100644
--- a/doc/linux.rst
+++ b/doc/linux.rst
@@ -145,6 +145,26 @@ the values of ``<internal.ipv4.address>`` and ``<token>`` on the template below)
    (global) ``before_script`` phase in jobs requiring access to the registry.
 
 
+.. note::
+
+   If you'd like to allow the (shell-based) runner to clone repositories other
+   than the one being built, you need to ensure the following is configured at
+   ``~/.ssh/config`` of the user running the ``gitlab-runner`` process
+   (typically ``gitlab-runner``):
+
+   .. code-block:: text
+
+      Host gitlab.idiap.ch
+        ForwardX11 no
+        ForwardX11Trusted no
+        ForwardAgent yes
+        StrictHostKeyChecking no
+        ControlMaster auto
+        ControlPath /tmp/%r@%h-%p
+        ControlPersist 600
+        Compression yes
+
+
 Crontabs
 ========