Stash is now known as Bitbucket Server.
See the

Unknown macro: {spacejump}

of this page, or visit the Bitbucket Server documentation home page.

Skip to end of metadata
Go to start of metadata

This page...

... describes how to install, set up and start using Stash.

If you're upgrading Stash...

... you should read the Stash upgrade guide instead of this page.

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

1. Install Git

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.

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 for the first time. The Setup Wizard guides you to:


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.

Use Git

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

  • No labels