How to customize the clone URL for a Bitbucket Server Smart Mirror
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
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
Purpose
Once you have set up a smart mirror, you'll notice that Bitbucket Server provides a git clone url for you by default which may look something like:
git clone ssh://git@someMirrorHostname.net:7999/bitbucket1/someProject/someRepo.git
You may, however, want something other than what Bitbucket Server has generated in the the upstream identifier part of the clone URL.
Resolution
- Install Mirror
- Before starting mirror add the following to the $BITBUCKET_HOME/shared/bitbucket.properties file:
plugin.mirroring.upstream.namespace=<custom-upstream-identifier>
The <custom-upstream-identifier> bit will replace the Bitbucket Server generated upstream identifier portion of the clone URL.