Skip to main content

How Do I Use My Own Certificates?

ngrok manages TLS certificates for your domains automatically by default, and in general automatic management is recommended. However, you may also upload and manage the renewal and rotation of your TLS certificates yourself.

warning

You cannot use your own certificates with ngrok's managed domains.

Uploading your own certificates may be the right choice if you are:

  • Issuing certificates from your own preferred certificate authority
  • Using an EV certificate

Using your own certificate​

To use your own TLS certificates with ngrok, you first need to upload the certificate, then attach it to a domain. To do so:

  1. Upload a certificate bundle and a private key. You can do this with one of the following:
  2. After you create your TLS certificate, you must attach it to one or more domains on ngrok before it can be used for termination. You can do so with one of the following:
    • The Domains section of the dashboard
      1. Select your domain.
      2. Expand the dropdown that says "Automated TLS Certificates" to choose the "Use an uploaded certificate" option.
    • With the Domains API resource, using the certificate_id property in the request body. You must have already uploaded your TLS certificate with the API or dashboard. 
      Loading…