Stash 3.8 installed fine with server.xml file in same Installation/conf directory

I upgraded to stash 3.8 using .tar.gz in staging and left the server.xml file under the $STASH_INST/conf directory and it came up fine. However, the upgrade and readme documentation indicate that  in version 3.8 it's location must be changed to home/shared and the mysql driver should also be moved to stash home/lib.  It seems to be running fine with both files in the old installation directories.  Do I really need to move them from installation directories to home directories?

4 answers

1 accepted

0 votes
Accepted answer

Hi Alicia,

As you observed it will work if you don't have the files under the STASH_HOME.

However, as of 3.8, we changed Stash to source these files from STASH_HOME so when customers upgrade, there is no need to manually update the new installation with previous customizations (i.e. MySQL driver or server.xml).

To explain it further, our upgrade process basically consists of (this is all done by the installer and no manual intervention is required):

  • Download the newest binaries and deploy them from scratch onto your system in a directory different to the previous Stash release installation
  • Point these new binaries to the existing STASH_HOME 

You see? The content of the STASH_INSTALLATION always changes (they are always fresh from the installers we release) but the STASH_HOME is the one that is kept with your data through the upgrade process. Hence changing the code to source those files from STASH_HOME ensures that customers won't have to execute these steps manually after each upgrade in the future.

In case you have files in both directories, Stash will prioritize the ones on STASH_HOME for the same reasons.

Kind regards,
Thiago Bomfim

Thank you for the explaination.  I have my own scripts that wget the tar.gz package, installs it, diffs our customized files in our installation directory with yours and makes the changes accordingly, with an echo to the screen to make sure it's done properly.  Sounds like maybe I should try using your installer now and decommission my custom scripts.

Best Regards,


Hi Alicia! Definitely! We've been improving our installer to accommodate your needs and it now has an upgrade flow. Please use it and give us your feedback.

0 votes
Boris Berenberg Community Champion Apr 20, 2015

We recommend you move the files to the new location for long term stability during other upgrades.

Shouldn't the new tar.gz installation package exclude the server.xml file now that it's supposed to live under home?  What about the web.xml file?  Could that be moved to home as well?  My scripts modfiy both of those files for our own customization as well as modify the INST start and stop .sh files and our environment settings.



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 ...

1,927 views 7 10
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