diff options
| author | Drew Blessing <drew@blessing.io> | 2019-05-01 06:13:14 +0000 |
|---|---|---|
| committer | Achilleas Pipinellis <axil@gitlab.com> | 2019-05-01 06:13:14 +0000 |
| commit | 0fcfcbaf425972efee4b07035db2312f2ce8e04d (patch) | |
| tree | 61b3e5c91daf04b081d96bd7767746cec7662b72 | |
| parent | acbfe10749b130497a06b8d2430b86a8b459622e (diff) | |
| download | gitlab-ce-0fcfcbaf425972efee4b07035db2312f2ce8e04d.tar.gz | |
Add SSH MaxStartups documentation
| -rw-r--r-- | doc/topics/git/troubleshooting_git.md | 27 |
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, |