GitKraken Desktop Documentation

Installing Self-Signed Certificates for GitKraken Desktop

Last updated: November 2026

Use this page to install a self-signed SSL certificate so GitKraken Desktop can trust a private or internally signed remote host. You export the certificate with a browser, add it to your system’s trusted certificates, and fix the most common SSL errors.

Requirements and limits

  • Use case: Private or internally signed remote hosts that GitKraken Desktop does not trust by default
  • Windows workflow on this page: Chrome-based certificate export and trusted root installation
  • macOS workflow on this page: Safari export and Keychain Access trust configuration
  • Linux workflow on this page: Chrome export plus openssl and certutil installation steps
  • Git SSL settings: GitKraken Desktop honors SSL settings in the global .gitconfig for Git actions
  • Common failure mode: Missing or invalid SAN values can require the server certificate to be reissued
OS Export step Install location Notes
Windows Export the certificate from Chrome Windows Trusted Root Certificates store Restart GitKraken Desktop after installing if needed
macOS Export the certificate from Safari Keychain Access Set trust to Always Trust if required
Linux Export the certificate from Chrome System certificate trust store Exact install path depends on the distribution

Quick Start

On Windows (Chrome):

  1. Navigate to your remote hosting service in Chrome and open the certificate details.
  2. Export the certificate using the Certificate Export Wizard.
  3. Open Chrome Settings, go to Privacy and Security > Security, and click Manage certificates.
  4. Import the certificate and add it to the Trusted Root Certificates store.

On macOS (Safari):

  1. Open Safari and navigate to your remote host.
  2. Hold Option and drag the certificate icon to your desktop to save it as a .pem file.
  3. Double-click the file to open Keychain Access.
  4. Find the certificate in the login keychain, open it, and set trust to Always Trust.
  5. Restart your computer.

On Linux (Chrome/Ubuntu):

  1. Export the certificate using the steps from the Windows Chrome section.
  2. Convert and install using openssl and certutil in the terminal.
  3. Reopen Chrome to confirm the warning no longer appears.

GitKraken Desktop also honors SSL settings in your global .gitconfig for Git actions.


How to add a self-signed certificate

GitKraken Desktop trusts a self-signed certificate only after you add it to your system’s trusted root certificates. You can add it through your operating system or through a browser.

Note: GitKraken Desktop runs Git actions with the Git selected in Git Executable, so it honors SSL settings in the global .gitconfig file for those actions.

How to use Google Chrome on Windows

On Windows, you can export and install the certificate with Google Chrome.

To export the certificate, go to your remote hosting service’s website in Chrome and open the certificate details:

Certificate view in Chrome with export option
Certificate view in Chrome with export option

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

Certificate export wizard in Chrome
Certificate export wizard in Chrome

Open Chrome’s Settings menu from the top-right .

Chrome settings menu
Chrome settings menu

Navigate to Privacy & Security Security:

Privacy & Security settings in Chrome
Privacy & Security settings in Chrome

Scroll down and click Manage certificates. Use the wizard to import the certificate.

Certificate management dialog in Chrome
Certificate management dialog in Chrome

Make sure the wizard adds the certificate to your trusted root certificates.

Wizard with trusted root option
Wizard with trusted root option

How to use Safari on macOS

Open Safari and navigate to your remote hosting service.

Remote host with invalid certificate in Safari
Remote host with invalid certificate in Safari

Open the certificate details window:

Certificate details window in Safari
Certificate details window in Safari

Hold down the Option key and drag the certificate icon to the desktop. This saves it as a .pem file.

Dragging certificate to save it as a .pem file
Dragging certificate to save it as a .pem file

Double-click the file to open it in Keychain Access.

macOS Keychain interface
macOS Keychain interface

Find the certificate in the login keychain and double-click it to open its settings.

Certificate settings in Keychain Access
Certificate settings in Keychain Access

Set the trust level to Always Trust. Restart your computer to apply the changes.

How to use Chrome on Ubuntu Linux

Export the certificate with Chrome as in How to use Google Chrome on Windows. Then install it from a terminal:

  1. Go to your Downloads folder.

  2. Convert the certificate and add it to the certificate database:

    openssl x509 -outform der -in DOWNLOADED-CERT-NAME -out DOWNLOADED-CERT-NAME.crt
    certutil -d sql:$HOME/.pki/nssdb -A -t "CT,C,C" -n DOWNLOADED-CERT-NAME.crt -i DOWNLOADED-CERT-NAME.crt
  3. Verify the certificate:

    certutil -d sql:$HOME/.pki/nssdb -L

Close and reopen Chrome to confirm the certificate warning no longer appears.

Common certificate errors

If GitKraken Desktop shows one of these SSL certificate errors, fix it as follows.

How to fix Invalid SSL Certificate

GitKraken invalid SSL certificate warning
GitKraken invalid SSL certificate warning

This error means the certificate is invalid or missing from your local store. Add the certificate to your local store.

Additional details about SSL certificate errors

Detailed certificate error from GitKraken
Detailed certificate error from GitKraken

A detailed error like this one can point to a problem in the server certificate itself, such as a missing Subject Alternative Name (SAN). Contact your server administrator to fix and reissue the certificate.

Operating system guides

For more help installing certificates on your operating system, see:

Windows Microsoft Docs
macOS Apple Docs
Linux Ubuntu Docs

pre{position:relative;min-height:3em}
.copy-btn{position:absolute;top:8px;right:8px;display:flex;align-items:center;justify-content:center;height:28px;padding:0 8px;background:rgba(128,128,128,.12);border:1px solid rgba(128,128,128,.2);border-radius:4px;cursor:pointer;color:#999;opacity:0;transition:opacity .15s,background .15s,color .15s;font-size:11px;font-family:sans-serif}
pre:hover .copy-btn{opacity:1}
.copy-btn:hover{background:rgba(128,128,128,.25);color:#555}
.copy-btn.copied{color:#22c55e;border-color:rgba(34,197,94,.3)}

(function(){var C=’Copy’,K=’Copied!’;function cp(t){if(navigator.clipboard&&window.isSecureContext)return navigator.clipboard.writeText(t);var x=document.createElement(‘textarea’);x.value=t;x.style.cssText=’position:fixed;opacity:0′;document.body.appendChild(x);x.select();try{document.execCommand(‘copy’)}catch(e){}document.body.removeChild(x);return Promise.resolve()}function init(){document.querySelectorAll(‘pre’).forEach(function(p){if(p.querySelector(‘.copy-btn’))return;var b=document.createElement(‘button’);b.className=’copy-btn’;b.setAttribute(‘aria-label’,’Copy code’);b.innerHTML=C;p.appendChild(b);b.addEventListener(‘click’,function(){var el=p.querySelector(‘code’)||p,cl=el.cloneNode(true),bn=cl.querySelector(‘.copy-btn’);if(bn)bn.remove();cp((cl.innerText||cl.textContent).trimEnd()).then(function(){b.innerHTML=K;b.classList.add(‘copied’);setTimeout(function(){b.innerHTML=C;b.classList.remove(‘copied’)},2000)})})})}document.readyState===’loading’?document.addEventListener(‘DOMContentLoaded’,init):init()})()

Have feedback about this article? Did we miss something? Let us know!
On this page