Add a note about symlinks. Fixes #625

README.md

@@ -397,6 +397,8 @@ the `git-data` parent directory by adding the following line to
 git_data_dir "/mnt/nas/git-data"
 ```
+Note that the target directory and any of its subpaths must not be a symlink.
+
 Run `sudo gitlab-ctl reconfigure` for the change to take effect.
 If you already have existing Git repositories in `/var/opt/gitlab/git-data` you

files/gitlab-config-template/gitlab.rb.template

@@ -116,7 +116,8 @@ external_url 'GENERATED_EXTERNAL_URL'
 ## For setting up different data storing directory
 ## see https://gitlab.com/gitlab-org/omnibus-gitlab/blob/629def0a7a26e7c2326566f0758d4a27857b52a3/README.md#storing-git-data-in-an-alternative-directory
-## If you want to use a single non-default directory to store git data use:
+## If you want to use a single non-default directory to store git data use
+## a path that doesn't contain symlinks.
 # git_data_dir "/var/opt/gitlab/git-data"
 # gitlab_rails['satellites_timeout'] = 30