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

1 vote
Accepted answer

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
Community showcase
Published Nov 06, 2018 in Bitbucket

Upgrade Best Practices

Hello! My name is Mark Askew and I am a Premier Support Engineer for products Bitbucket Server/Data Center, Fisheye & Crucible. Today, I want to bring the discussion that Jennifer, Matt, and ...

691 views 5 9
Read article

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