Getting started

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. See our Supported platforms page to find out about system requirements.

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. Stash also requires at least Perl 5.8.8.

2. Install Stash  

Download and run the Stash installer:

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

• They install a supported version of Java, if necessary.
• They launch Stash when they finish.

See Running the Stash installer for details about: 

• Installing Stash as a service on Linux and Windows systems.
• Running the installer in a console or in unattended mode.

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

Using Stash in the enterprise

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

• Using Stash in the enterprise
• High availability for Stash
• Scaling Stash
• Scaling Stash for Continuous Integration performance
• Bitbucket Data Center resources
• Stash production server data

Use Git

We have some information here to help get you up and running with Git:

• Git Tutorials and Training
• Basic Git commands
• Permanently authenticating with Git repositories
• Using SSH keys to secure Git operations
• Git resources