summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAchilleas Pipinellis <axil@gitlab.com>2019-05-01 06:13:15 +0000
committerAchilleas Pipinellis <axil@gitlab.com>2019-05-01 06:13:15 +0000
commitdf6b92d9a2c005775f86645f6e4293f818a0ca99 (patch)
tree61b3e5c91daf04b081d96bd7767746cec7662b72
parentacbfe10749b130497a06b8d2430b86a8b459622e (diff)
parent0fcfcbaf425972efee4b07035db2312f2ce8e04d (diff)
downloadgitlab-ce-df6b92d9a2c005775f86645f6e4293f818a0ca99.tar.gz
Merge branch 'docs-ssh-maxstartups' into 'master'
Add SSH MaxStartups documentation See merge request gitlab-org/gitlab-ce!27837
-rw-r--r--doc/topics/git/troubleshooting_git.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/doc/topics/git/troubleshooting_git.md b/doc/topics/git/troubleshooting_git.md
index d1729d70158..71651fcf421 100644
--- a/doc/topics/git/troubleshooting_git.md
+++ b/doc/topics/git/troubleshooting_git.md
@@ -78,6 +78,33 @@ git push
In case you're running an older version of Git (< 2.9), consider upgrading
to >= 2.9 (see [Broken pipe when pushing to Git repository][Broken-Pipe]).
+## `ssh_exchange_identification` error
+
+Users may experience the following error when attempting to push or pull
+using Git over SSH:
+
+```
+Please make sure you have the correct access rights
+and the repository exists.
+...
+ssh_exchange_identification: read: Connection reset by peer
+fatal: Could not read from remote repository.
+```
+
+This error usually indicates that SSH daemon's `MaxStartups` value is throttling
+SSH connections. This setting specifies the maximum number of unauthenticated
+connections to the SSH daemon. This affects users with proper authentication
+credentials (SSH keys) because every connection is 'unauthenticated' in the
+beginning. The default value is `10`.
+
+Increase `MaxStartups` by adding or modifying the value in `/etc/ssh/sshd_config`:
+
+```
+MaxStartups 100
+```
+
+Restart SSHD for the change to take effect.
+
## Timeout during git push/pull
If pulling/pushing from/to your repository ends up taking more than 50 seconds,