Getting started

To install and start using Stash, read on!

If you're upgrading Stash

... read the Stash upgrade guide instead.

For production installs

... we highly recommend that you first read Using Stash in the enterprise.

Atlassian Stash is the on-premises Git repository management solution for enterprise teams. It allows everyone in your organization to easily collaborate on your Git repositories.

1. Install Git and Perl

Stash requires Git on the machine that will run Stash. If you need to check, install, or upgrade Git on the Stash server machine, see Installing and upgrading Git.

Check that you have all the other system requirements, including Perl, to avoid any trouble.

2. Install Stash

Installers are available for the Linux, Mac OS X and Windows operating systems:

See Running the Stash installer for details.

You may be interested in these alternative provisioning approaches:

3. Set up Stash

The Stash Setup Wizard runs automatically when you visit Stash in your browser the first time Stash is started. The Setup Wizard guides you to:

Specify the default language for Stash.
Connect Stash to an external database (the internal HSQL database is great for evaluating Stash, but is not recommended for production installations). You'll need to have created the external database before running the Setup Wizard. For MySQL, you'll need to have installed the JDBC driver too.
Enter your Stash license key.
Set the base URL for Stash.
Set up an administrator account.
Integrate Stash with JIRA.
Log in to Stash.

If you are intending to use Stash for a production installation, see also Using Stash in the enterprise.

4. Set up the mail server

Configuring the Stash email server allows users to receive a link from Stash that lets them generate their own passwords. See Setting up your mail server.

5. Get working with Stash

Work with projects

Stash manages related Git repositories as projects. Find out how to set up projects and give your teams access to those.

If you have existing projects that you want to manage in Stash, then you'll want to read Importing code from an existing project.

Integrate Stash with other Atlassian applications

See Integrating Stash with Atlassian applications for an overview of what is possible.

As a first step, see JIRA integration for information about using Stash with JIRA.

If you want to see results from your continuous integration or build server in Stash, see Bamboo integration.

Use Stash in your enterprise

If you are intending to use Stash in large-scale production environments, see:

Use Git

We have some information here to help you get going with Git:

Page tree