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

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 Join to answer
Community showcase
Piotr Plewa
Published Dec 27, 2017 in Bitbucket

Recipe: Deploying AWS Lambda functions with Bitbucket Pipelines

Bitbucket Pipelines helps me manage and automate a number of serverless deployments to AWS Lambda and this is how I do it. I'm building Node.js Lambda functions using node-lambda&nbsp...

635 views 0 4
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot