Hey! We're going to install Stash on Windows. There are a few steps, but we think you'll really like Stash once it's up and running. 1. Check supported platformsBetter check the Supported platforms page first; it lists the application servers, databases, operating systems, web browsers and JDKs that we have tested Stash with and recommend. Atlassian only officially supports Stash running on x86 hardware and 64-bit derivatives of x86 hardware. |
2. Check your version of Java
In a command prompt, run this:
java -version
The version of Java should be 1.6.0 or higher.
3. Check that Windows can find Java
Windows uses the JAVA_HOME environment variable to find Java. To check that, in a command prompt, run:
echo %JAVA_HOME%
You should see a path to the Java install location that does not contain spaces.
4. Check your version of Git
In a command prompt, run:
git --version
The version of Git should be 1.7.6 or higher.
5. Now it's time to get Stash
Download Stash from the Atlassian download site.
Extract the downloaded file to an install location. The path to the extracted directory is referred to as the
in these instructions.<Stash installation directory>
6. Tell Stash where to store your data
The Stash home directory is where your Stash data is stored.
You should not locate your Stash home directory inside the
— they should be entirely separate locations. If you do put the home directory in the <Stash installation directory>
it will be overwritten, and lost, when Stash gets upgraded. And, by the way, you can't use the same Stash home directory for multiple instances of Stash.<Stash installation directory>
Create your Stash home directory, and then tell Stash where you created it by setting a STASH_HOME
environment variable, as follows.
For Windows 7:
- Go to Start, search for "sys env" and choose Edit the system environment variables.
- Click Environment Variables, and then New under 'System variables'.
- Enter "
STASH_HOME
" as the Variable name, and the absolute path to your Stash home directory as the Variable value. Don't use a trailing backslash.
7. Start Stash!
In a command prompt, change directory to the <Stash installation directory>
and run:
bin\start-stash.bat
In your browser, go to http://localhost:7990 and run through the Setup Wizard. In the Setup Wizard:
- Select Internal at the 'Database' step, if you are evaluating Stash. Stash will happily use its internal database, and you can easily migrate to external database later. See Connecting Stash to an external database.
- You can set up JIRA integration, but you can also do this later if you wish. See Configuring JIRA integration in the Setup Wizard.
8. Set up your mail server
Configure your email server so users can receive a link from Stash that lets them generate their own passwords. See Setting up your mail server.
9. Additional steps for production environments
For production environments we recommend that you configure the additional aspects below. These are not necessary when installing for evaluation purposes.
Use an external database
For production environments Stash should use an external database, rather than the embedded database. See Connecting Stash to an external database.
Secure the Stash home directory
For production environments the Stash home directory (created in step 7 above) should be secured against unauthorised access. See Stash home directory.
Secure Stash with HTTPS
For production environments access to Stash should be secured using HTTP over SSL, especially if your data is sensitive and Stash is exposed to the internet. See Securing Stash with HTTPS.
Run Stash as a Windows service
See Running Stash as a Windows service.
10. Stop Stash (optional)
In a command prompt, change directory to the <Stash installation directory>
and run:
bin\stop-stash.bat
Attachments:








