Change BITBUCKET_HOME when installed as a Windows service
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
When Bitbucket Server is installed as a Windows service, the Bitbucket home directory location, defined by the BITBUCKET_HOME variable in setenv.bat is not used. This is because the Bitbucket Server service has the -Dbitbucket.home hardcoded based on the value that was used when the installation was run. This page outlines how to change the BITBUCKET_HOME variable for the Windows service.
Solution
How to change BITBUCKET_HOME for the Windows service
Stop the Bitbucket Server service.
Open the command window from
Start >> Run >> type in 'cmd' >> Entercdto thebindirectory the Bitbucket Server Installation (<Bitbucket Server Installation dir>/bin).Run from there:
1bservmgr.exe //ES/AtlassianBitbucketA window will pop up. Click on the Java tab to see the list of current start-up options. Under "Java Options:" form, input the value:
1-Dbitbucket.home=C:/absolute/path/to/your/bitbucket/home
Restart Bitbucket Server Service. From here the service will be forced to point to the path defined on the property
-Dbitbucket.homeabove.
Was this helpful?