atlassian/stash repository overview

⁠This image has been deprecated!

Stash is now Bitbucket Server. For the latest Docker images, checkout the new repository from bitbucket.org⁠ or hub.docker.com⁠.

To read all the details check out this announcement⁠.

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

⁠Overview

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.

⁠Upgrade

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.

⁠Backup

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: https://confluence.atlassian.com/display/STASH/Data+recovery+and+backups⁠

⁠Versioning

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.