Move from Stash zip install to using installer?


I've been installing upgrades of Stash using the provided .zip downloads for Windows. I was wondering what the process is for migrating from that [kind of] installation process to the installer provided? I searched docs without success.

I am running Stash as a service, and 64 bit, and Windows system environment variables are set.

Any pointers would be appreciated.



2 answers

1 accepted

0 votes
Accepted answer

FYI Here's what happened - I hope my experience helps others. I'm on Windows 2012R2 using MySQL.

I deleted the contents of the zip file Stash installation directory, uninstalled Java JDK and JRE and removed the Windows service using sc.

I ran the installer as administrator, chose my previous paths for installation dir and Stash Home (repo). It installed fine, said it was installing the service, but no service was created and there were no errors during the installation. I followed another help area in Stash and got a service set up. I also set the service to start as the new atlstash user, and for it to be a delayed start (I've found this gives mysql and other services time to start up properly).

I do not remember if I had to modify the executables to run the 64 bit versions like you do in the zip install, but the 64 bit versions are in place.

I set my system environment variables to the new JRE path (JAVA_HOME and JRE_HOME). My previous system environment variables for STASH_HOME did not need modifications. I found in previous versions that if running as a service these environment variables make life a lot easier.

In the previous zip installation, I had created a different user for Stash to run as per its instructions. I now had to remove that user and apply permissions to the Stash installation and STASH_HOME directory for the atlstash user which the installer created.

After that, so far smooth sailing. I might add that this is all running in a VMware environment, so my backup and revert plan was a snapshot, making this a very low-risk process.

Thanks for your help in the transition.



Hi John, the process to move from zip to installer is the same as the upgrade proccess described here.



Should I uninstall my existing instances of the JRE/JDK, or can I continue to manage that separately?

Also, do you know if the installer creates or modifies any existing system environment variables?


Hi John, the installer is shipped with a bundled JRE, there's no need to uninstall your existing JAVA instance, but Stash won't use it by default.

Also, the installer won't modify your system variables, but it will use the definitions in its setenv file.


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,905 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