How to obtain the SSH fingerprint from Bitbucket Server without connecting to it first

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

For security reasons it may be desirable to obtain the SSH fingerprint that Bitbucket Server or Data Center's SSH server will send without connecting via SSH first. This document explains how to retrieve the fingerprint using an alternative method.

Environment

Bitbucket Server or Data Center

Solution

To retrieve the SSH fingerprint, perform the following steps on the machine where Bitbucket Server is installed. In case of a Bitbucket Data Center instance you can perform these steps on any one of the nodes.

  1. Copy the SSH key pair to a temporary location

    1 cp <BitbucketHome>/shared/config/ssh-server-keys.pem /tmp

    where <BitbucketHome> is the Bitbucket Server home directory.

    ℹ️ The file may not exist. This can happen if SSH is not enabled in Bitbucket Server or if no connection to Bitbucket Server's SSH server was ever made.

  2. Change the permissions on the temporary file so only the owner can access it

    1 chown 600 /tmp/ssh-server-keys.pem
  3. Run the ssh-keygen utility to extract the SSH fingerprint from the key pair file

    1 ssh-keygen -lf /tmp/ssh-server-keys.pem

    This will produce output similar to this:

    1 2048 SHA256:U+NO3sOxbAvVCtF1NCN/ZL2+rWJ9bddDQSoGom1TsI8 no comment (RSA)

    In this example output the fingerprint is U+NO3sOxbAvVCtF1NCN/ZL2+rWJ9bddDQSoGom1TsI8

Updated on April 2, 2025

Still need help?

The Atlassian Community is here for you.