Installing Stash on Linux and Mac

2. Check your version of Java

In a terminal, run this:

java -version

The version of Java should be 1.6.0 or higher.

3. Check that the system can find Java

In a terminal, run this:

echo $JAVA_HOME

You should see a path like /System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home/.

echo JAVA_HOME="path/to/JAVA_HOME" >> /etc/environment

JAVA_HOME="path/to/JAVA_HOME"
export JAVA_HOME

source ~/.profile
$JAVA_HOME/bin/java -version

4. Check your version of Git

In a terminal, run this:

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 <Stash installation directory> in these instructions.

6. Tell Stash where to store your data

The Stash home directory is where your Stash data is stored.

Create your Stash home directory (without spaces in the name), and then tell Stash where you created it by editing the <Stash installation directory>/bin/setenv.sh file – uncomment the STASH_HOME line and add the absolute path to your home directory. Here's an example of what that could look like when you're done:

 You should not locate your Stash home directory inside the <Stash installation directory> — 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'll need separate Stash home directories if you want to run multiple instances of Stash.

7. Start Stash!

In a terminal, change directory to <Stash installation directory> and run this:

bin/start-stash.sh

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 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. Add users and repositories

Now is the time to set up your users in Stash, and to tell Stash about any existing repositories you have. Please the following pages for the details:

• Getting started with Git and Stash
• Importing code from an existing project

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.

Connect to your existing user directory

• See External user directories.

10. Stop Stash (optional)

In a terminal, change directory to <Stash installation directory> and run this:

bin/stop-stash.sh