Octopus Deploy Documentation

Import certificate

Last updated

Replace the certificate that Tentacle uses to authenticate itself.

Import certificate options

Usage: tentacle import-certificate [<options>]

Where [<options>] is any of:

      --instance=VALUE       Name of the instance to use
      --config=VALUE         Configuration file to use
  -r, --from-registry        Import the Octopus Tentacle 1.x certificate from
                               the Windows registry
  -f, --from-file=VALUE      Import a certificate from the specified file
                               generated by the new-certificate command or a
                               Personal Information Exchange (PFX) file
      --pw, --pfx-password=VALUE
                             Personal Information Exchange (PFX) private key

Or one of the common options:

      --help                 Show detailed help for this command

Basic example

This example imports a certificate from a .pfx file:

This command will import the first certificate it finds. If the .pfx file contains the entire certificate chain, it will attempt to load the first one, which is often the certificate for the Certificate Authority, and fail will with an error that it is unable to load the private key.

tentacle import-certificate --from-file="c:\temp\MyCertificate.pfx" --pfx-password="$uper$ecretP@ssw0rd!"
tentacle import-certificate --from-file="/tmp/MyCertificate.pfx" --pfx-password="$uper$ecretP@ssw0rd!"

Need support? We're here to help.