From 94be3a7762ba14a351ca4496ba92943e6f0d9633 Mon Sep 17 00:00:00 2001
From: Andre Anjos <andre.dos.anjos@gmail.com>
Date: Mon, 25 Feb 2019 15:13:48 +0100
Subject: [PATCH] [doc] Add more tips for the setup of the linux runner

---
 doc/linux.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/linux.rst b/doc/linux.rst
index 38ee9185..ce772437 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
 ========
 
-- 
GitLab