diff options
author | Patricio Cano <suprnova32@gmail.com> | 2016-03-03 19:21:32 +0300 |
---|---|---|
committer | Patricio Cano <suprnova32@gmail.com> | 2016-03-03 19:21:32 +0300 |
commit | cf232411ae37b68c9d6ab20deac3fc8d99b44124 (patch) | |
tree | 8c2dccd528d5ceb234a65b03a15c19ab0a6710f0 /doc/integration/README.md | |
parent | 00cb4a97147a8f760d37c5f6fae11f93ba4ede34 (diff) |
Added Troubleshooting information for most used services.
Diffstat (limited to 'doc/integration/README.md')
-rw-r--r-- | doc/integration/README.md | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/doc/integration/README.md b/doc/integration/README.md index 281eea8363d..7c8f785a61f 100644 --- a/doc/integration/README.md +++ b/doc/integration/README.md @@ -39,3 +39,34 @@ please see the [project_services directory][projects-code]. [jenkins]: http://doc.gitlab.com/ee/integration/jenkins.html [Project Service]: ../project_services/project_services.md [projects-code]: https://gitlab.com/gitlab-org/gitlab-ce/tree/master/app/models/project_services + +## SSL certificate errors + +When trying to integrate GitLab with services that are using self-signed certificates, +it is very likely that SSL certificate errors will occur on different parts of the +application, most likely Sidekiq. There are 2 approaches you can take to solve this: + +1. Add the root certificate to the trusted chain of the OS. +1. If using Omnibus, you can add the certificate to GitLab's trusted certificates. + +**OS main trusted chain** + +This [resource](http://kb.kerio.com/product/kerio-connect/server-configuration/ssl-certificates/adding-trusted-root-certificates-to-the-server-1605.html) +has all the information you need to add a certificate to the main trusted chain. + +This [answer](http://superuser.com/questions/437330/how-do-you-add-a-certificate-authority-ca-to-ubuntu) +at SuperUser also has relevant information. + +**Omnibus Trusted Chain** + +It is enough to concatenate the certificate to the main trusted certificate: + +```bash +cat jira.pem >> /opt/gitlab/embedded/ssl/certs/cacert.pem +``` + +After that restart GitLab with: + +```bash +sudo gitlab-ctl restart +``` |