Public | Automated Build

Last pushed: 2 years ago
Short Description
On-premises source code management for Git that's secure, fast, and enterprise grade.
Full Description

This image has been deprecated!

Stash is now Bitbucket Server. For the latest Docker images, checkout the new repository from or

To read all the details check out this announcement.

Stash Docker images are no longer supported and are not recommended for production use.


This Docker container makes it easy to get an instance of Stash up and running
for evaluative purposes. Atlassian is not yet able to provide support for using Docker in production.

Quick Start

For the STASH_HOME directory that is used to store the repository data
(amongst other things) we recommend mounting a host directory as a data volume:

Set permissions for the data directory so that the runuser can write to it:

$> docker run -u root -v /data/stash:/var/atlassian/application-data/stash atlassian/stash chown -R daemon  /var/atlassian/application-data/stash

Start Atlassian Stash:

$> docker run -v /data/stash:/var/atlassian/application-data/stash --name="stash" -d -p 7990:7990 -p 7999:7999 atlassian/stash

Success. Stash is now available on http://localhost:7990*

Please ensure your container has the necessary resources allocated to it.
We recommend 2GiB of memory allocated to accommodate both the application server
and the git processes.
See Supported Platforms for further information.

* Note: If you are using boot2docker on Mac OS X, please use open http://$(boot2docker ip):7990 instead.


To upgrade to a more recent version of Stash you can simply stop the stash
container and start a new one based on a more recent image:

$> docker stop stash
$> docker rm stash
$> docker run ... (See above)

As your data is stored in the data volume directory on the host it will still
be available after the upgrade.

Note: Please make sure that you don't accidentally remove the stash
container and its volumes using the -v option.


For evalutations you can use the built-in database that will store its files in the Stash home directory. In that case it is sufficient to create a backup archive of the directory on the host that is used as a volume (/data/stash in the example above).

The Stash Backup Client is currently not supported in the Docker setup. You can however use the Stash DIY Backup approach in case you decided to use an external database.

Read more about data recovery and backups:


The latest tag matches the most recent release of Atlassian Stash.
Thus atlassian/stash:latest will use the newest version of Stash available.

Alternatively you can use a specific minor version of Stash by using a version number
tag: atlassian/stash:3.5. This will install the latest 3.5.x version that
is available.

Issue tracker

Please raise an
issue if you
encounter any problems with this Dockerfile.

Docker Pull Command