Bitbucket Server is an on-premises source code management solution for Git that's secure, fast, and enterprise grade. Create and manage repositories, set up fine-grained permissions, and collaborate on code - all with the flexibility of your servers.
Learn more about Bitbucket Server: https://www.atlassian.com/software/bitbucket/server
This Docker container makes it easy to get an instance of Bitbucket up and running.
BITBUCKET_HOME directory that is used to store the repository data
(amongst other things) we recommend mounting a host directory as a data volume, or via a named volume if using a docker version >= 1.9.
For Bitbucket 4.12+
In Bitbucket 4.12 and later versions, volume permission is managed by entry scripts. To get started you can use a data volume, or named volumes. In this example we'll use named volumes.
$> docker volume create --name bitbucketVolume $> docker run -v bitbucketVolume:/var/atlassian/application-data/bitbucket --name="bitbucket" -d -p 7990:7990 -p 7999:7999 atlassian/bitbucket-server
For other versions
Set permissions for the data directory so that the runuser can write to it:
$> docker run -u root -v /data/bitbucket:/var/atlassian/application-data/bitbucket atlassian/bitbucket-server chown -R daemon /var/atlassian/application-data/bitbucket
Note that this command can be replaced by named volumes.
Start Atlassian Bitbucket Server:
$> docker run -v /data/bitbucket:/var/atlassian/application-data/bitbucket --name="bitbucket" -d -p 7990:7990 -p 7999:7999 atlassian/bitbucket-server
Success. Bitbucket 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
docker-machine on Mac OS X, please use
open http://$(docker-machine ip default):7990 instead.
Reverse Proxy Settings
If bitbucket is run behind a reverse proxy server as described here,
then you need to specify extra options to make bitbucket aware of the setup. They can be controlled via the below
The reverse proxy's fully qualified hostname.
The reverse proxy's port number via which bitbucket is accessed.
The protocol via which bitbucket is accessed.
Set 'true' if CATALINA_CONNECTOR_SCHEME is 'https'.
To upgrade to a more recent version of Bitbucket Server you can simply stop the
container and start a new one based on a more recent image:
$> docker stop bitbucket $> docker rm bitbucket $> 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
container and its volumes using the
For evaluations you can use the built-in database that will store its files in the Bitbucket Server 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/bitbucket in the example above).
Read more about data recovery and backups: https://confluence.atlassian.com/display/BitbucketServer/Data+recovery+and+backups
latest tag matches the most recent release of Atlassian Bitbucket Server.
atlassian/bitbucket:latest will use the newest version of Bitbucket Server available.
Alternatively you can use a specific minor version of Bitbucket Server by using a version number
atlassian/bitbucket-server:4.0. This will install the latest
4.0.x version that
Please raise an
issue if you
encounter any problems with this Dockerfile.
For product support, go to support.atlassian.com