docker container and docker-compose file for gitbucket

data/ conf add mysql config 6 years ago
docker update to version 4.21.2 5 years ago
.env inital commit 6 years ago
.gitignore merge scripts into 5 years ago add license 6 years ago using master build state 5 years ago fix mysql backup 6 years ago update to version 4.21.2 5 years ago
docker-compose.yml remove temorary the tmp dir because gitbucket fails on start 5 years ago
gitbucket.conf.example merge scripts into 5 years ago merge scripts into 5 years ago

docker container for gitbucket

Build Status Donate

This docker container of gitbucket is in beta state!

Table of contents




Please make a backup from the hole directory bevor update your repsitory and commit your changes!

from 4.19.3 to 4.20.0

You have to backup your gitbucket.conf because this config does not exist in the repository any more. You have to manage the config file manually. The new install script will create a local config fiel as copy from gitbucket.conf.example and generate new passwords.


  1. Get code from repository:

    git clone
    cd gitbucket
  2. Execute install script

  3. Change the confoguration and start with:

    docker-compose up -d
  4. Open and be habby. :-) Default user and passwort are both root.


Please use the configuration file gitbucket.conf for your personal changes. There are three configs for gitbucket:

  • GITBUCKET_BIND: ip address to bind to
  • GITBUCKET_WEB_PORT: web port to bind to
  • GITBUCKET_SSH_PORT: ssh port to bind to


Update your gitbucket image in three steps. But first of all: MAKE A BACKUP!!!

  1. Commit your local changes. Changes in gitbucket.conf will be ignored!

  2. get the new image Shutdown and remove your images. This will not delete your mysql database volume.

    docker-compose down

    After that get the new image and start it:

    docker-compose pull
    docker-compose up -d --remove-orphans
  3. cleanup your docker environment This step is optional. Please do this only if you understand the next line.

    docker rmi -f $(docker images -f "dangling=true" -q)


To use plugins download the plugin and move it into data/plugins. After that restart the gitbucket container with docker-compose restart main-gitbucket.


For backuping the mysql database and the repositories you could use the script and combine it with a daily cronjob. This script will create a compressed backup and keep the files 10 days in the backup directory. All files which are older then 10 days will be deleted.


Error 503 on first start

Please check the gitbucket log files with

docker-compose logs main-gitbucket

If you get Could not connect to address=(host= as error: Please restart the gitbucket container with docker-compose restart main-gitbucket because the mariadb container needs some time to run completly at the first start. After that it should be work. If doesn't please contact me via because gitbucket does not allow issues for guests.

Contact and Contribution

You can write me an email ( ) or you could register here as an user to contribute to this project. After register please fork this repository and create pull reqeusts with your changes or add an issue.


  • check gitbucket.war hash after download
  • maybe a nginx container with ssl???


I got some inspirations for this project from:


cc-bc-sa: Please see license

Gitbucket license