How to name a node in a Bitbucket mirror farm

Still need help?

The Atlassian Community is here for you.

Ask the community

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


When installing and configuring a mirror farm, a Bitbucket administrator (admin) may want to configure each node in the mirror farm with a custom name. When first configuring your mirror node, an admin can define the URL and display name. A unique ID will then be automatically generated for each node in the farm. The instructions below will allow the admin to define a custom name for each node.


Bitbucket Smart Mirror Farm


To set the name for the node, the process is the same for adding and removing Data Center nodes; you will set a JVM argument:

  1. On the mirror node, navigate to the installation path: BITBUCKET_INSTALLATION/bin
  2. Open file:
  3. Uncomment JVM_SUPPORT_RECOMMENDED_ARGS and add the following argument:
  4. Save and exit file.
  5. Restart the application for the change to take effect.

# Occasionally Atlassian Support may recommend that you set some specific JVM arguments. You can use this
# variable to do that. Simply uncomment the below line and add any required arguments. Note however, if this
# environment variable has been set in the environment of the user running this script, uncommenting the below
# will override that.

Last modified on Feb 24, 2021

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.