Skip to content

Self-Signed Certificates

GitKraken's remote hosting platform integrations may require users to have a certificate in place. Follow the instructions below to add a certifiate to your local certificate store.

Adding a Self-Signed Certificate

Self-signed certificates must be added to your trusted root directory before GitKraken will recognize the cert. This can be done through your operating system or in many browsers.

Note: SSL settings in the global .gitconfig file are not honored by GitKraken.

Using Google Chrome on Windows

An easy way to install a certificate so that GitKraken can use it is via Google Chrome.

To generate a self-signed certificate, navigate to your remote hosting services web site. You should see somthing like this:

Click on the certificate, go to Details and click Copy to File... then follow the Certificate Export Wizard.

Once you have the certificate on your machine, in Chrome go to Settings from the menu in the top right.

Then navigate to Privacy & Security Security:

Scroll down and then click Manage certificates. This will open a certificate import wizard dialog box, where you can click import. Follow the instructions in the wizard to browse to your certificate file and complete the installation.

Make sure to add the certificate to your trusted root certificates.

Using Safari on Mac

Open Safari and browse to your remote hosting service.

Click to open cerificate window and view the certificate:

Hold down Option key and drag the certificate icon onto desktop. This should save the file with a .pem extension.

Now double click the file to open your mac keychains.

Locate the certificate in the login section.

Double click on the certificate to open the configuration window. In the first box, change the value to be Always Trust.

Finally, log out and back in again or restart your machine and the certifacte will be recognized.

Common certificate errors

Help, I am getting Invalid SSL Certificate errors!

This typically indicates that there is either an invalid certificate or no certificate detected. To ensure that GitKraken is able to use your certificate, follow the above instructions to add a certificate to your local certificate store.

You may also recieve additional information about why the certificate is detected as invalid:

These will likely require the admin of the remote server to update the indicated field(s) and issue a new certificate. In this example a Server Alternate Name (SAN) is missing or incorrect.

Operating system guides

Please reference these guides for adding your certificate in your operating system if not using the above browser methods.

Windows Microsoft Docs
OSX Apple Docs
Linux Ubuntu Docs