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.


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.