Upgrade Stash 3.1 to BitBucket 5.3

I have Stash 3.1 installed on a server, now I want to upgrade it to BitBucket 5.3 to a new Server.

I have copied the stash-home directory to the new server, but i have a question regarding the server.xml file upgrade.

One instruction says "To migrate customizations made in the server.xml file to the bitbucket.properties file", but my problem is the old stash home dir doesnt have bitbucket.properties. (https://confluence.atlassian.com/bitbucketserver/migrate-server-xml-customizations-to-bitbucket-properties-897811761.html)

Another intruction says "If you are upgrading from Stash 3.7 or earlier and you made any changes to <Bitbucket Server installation directory>/conf/server.xml (for instance to secure your server with SSL):

  1. In the <BITBUCKET_HOME> directory, make a new directory called shared.
  2. Then, copy your modified server.xml file into <BITBUCKET_HOME>/shared/
    " (https://confluence.atlassian.com/bitbucketserver/install-bitbucket-server-from-an-archive-file-776640148.html)

Plesase tell me which one to follow?


1 answer

1 accepted

This widget could not be displayed.

If you upgrade from Stash to a Bitbucket 4.x version, the  <BITBUCKET_HOME>/shared/ instructions works.

But if you are going to upgrade to a 5.x version, then bitbucket.properties instructions are valid.

If the file does not exist, then create the file.

This is how a properties file on a linux system with a postgres DB could look like:

#>* DB Settings *

#> Set http port and proxy setting *

#> Specify path to git version *


Do I still need to keep stash-config.properties in the stash-home directory? I think DB settings are already specified in the new bitbucket.properties file.

No, I do not think you need to keep the file. New bitbucket installations run without stash-config.properties file.

Just make a backup and as always try to upgrade on a staging system first.

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Posted Friday in Bitbucket

What is your #1 piece of advice to new users getting started using Bitbucket?

Hello Community! My name is Claire Maynard, and I’m a Product Marketing Manager on the Bitbucket team. I’m interested in hearing what advice or tips you have for new users getting started on ...

165 views 9 2
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you