Added Troubleshooting information for most used services.

1 files changed, 27 insertions, 0 deletions

diff --git a/doc/integration/ldap.md b/doc/integration/ldap.md
index f256477196b..ac15a2cdffc 100644
--- a/doc/integration/ldap.md
+++ b/doc/integration/ldap.md
@@ -204,3 +204,30 @@ When setting `method: ssl`, the underlying authentication method used by
 `omniauth-ldap` is `simple_tls`.  This method establishes TLS encryption with 
 the LDAP server before any LDAP-protocol data is exchanged but no validation of
 the LDAP server's SSL certificate is performed.
+
+## Troubleshooting
+
+### Common problems
+
+**Invalid credentials when logging in**
+
+Make sure the user you are binding with has enough permissions to read the user's
+tree and traverse it.
+
+Also make sure that the `user_filter` is not blocking otherwise valid users.
+
+To make sure that the LDAP settings are correct and GitLab can see your users,
+execute the following command:
+
+For Omnibus installations:
+
+```bash
+sudo gitlab-rake gitlab:ldap:check
+```
+
+For installations from source:
+
+```bash
+sudo -u git -H bundle exec rake gitlab:ldap:check RAILS_ENV=production
+```
+