GitBucket plug-in that adds simple CI ability to GitBucket.
Branch: master
Clone or download
Latest commit 4a040ed Dec 12, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
project Update for API changes in GitBucket 4.30.0 Nov 10, 2018
src Fix for GitBucket 4.30.0 Dec 11, 2018
.gitignore first commit Sep 6, 2017
.travis.yml try openjdks too. Nov 20, 2018 Update Dec 12, 2018
build.sbt Fix for GitBucket 4.30.0 Dec 11, 2018
gitbucket-ci-plugin_output.png Update images Sep 16, 2017
gitbucket-ci-plugin_results.png Update images Sep 16, 2017

gitbucket-ci-plugin Build Status

GitBucket plug-in that adds simple CI ability to GitBucket.

Build results

Build output

This plug-in allows repository owners to configure build command, and run them at following timing:

  • Push commits to the default branch
  • Create a new pull request
  • Push additional commits to the pull request branch

Skip and re-run by keywords

You can skip a build by including specific words in the commit message. Moreover you can also re-run the pull request build by adding a comment including specific words. These words can be set at the build settings.

Variables in build script

In the build script, following environment variables are available:

  • CI (true)
  • HOME (root of the build directory)
  • CI_BUILD_DIR (same as HOME)
  • CI_REPO_SLUG ("owner/repo")
  • CI_PULL_REQUEST (pull request id or "false")
  • CI_PULL_REQUEST_SLUG ("owner/repo" or "")


This plugin has CircleCI API v1.1 compatible Web API. Supported APIs are below:

  • User (GET /api/circleci/v1.1/me)
  • Recent Builds For a Single Project (GET /api/circleci/v1.1/project/gitbucket/:owner/:repository)
  • Recent Builds For a Project Branch (GET /api/circleci/v1.1/project/gitbucket/:owner/:repository/tree/:branch)
  • Single Build (GET /api/circleci/v1.1/project/gitbucket/:owner/:repository/:buildNum)
  • Retry a Build (POST /api/circleci/v1.1/project/gitbucket/:owner/:repository/:buildNum/retry)
  • Cancel a Build (POST /api/circleci/v1.1/project/gitbucket/:owner/:repository/:buildNum/cancel)
  • Trigger a new Build (POST /api/circleci/v1.1/project/gitbucket/:owner/:repository)
  • Trigger a new Build with a Branch (POST /api/circleci/v1.1/project/gitbucket/:owner/:repository/tree/:branch)

While CircleCI API takes the token via query string, in this plugin, Authorization header (application token or basic authentication) is available as same as other GitBucket API.


Note that you must not use this plug-in in public environment because it allows executing any commands on a GitBucket instance. It will be a serious security hole.

In addition, this plug-in is made to just experiment continuous integration on GitBucket easily without complex settings of webhook or Jenkins. It doesn't have flexibility and scalability, and also has a security issue which is mentioned above. Therefore, if you like it and would like to use for your project actually, we recommend to setup Jenkins or other CI tool and move to it.


Plugin version GitBucket version
1.7.x 4.30.x -
1.6.x - 4.24.0 -
1.5.x - 4.23.1 -
1.4.x - 4.23.0
1.3.x - 4.19.x -
1.0.x - 1.2.x 4.17.x, 4.18.x


Download jar file from plugin registry and put into GITBUCKET_HOME/plugins.


Run sbt assembly and copy generated /target/scala-2.12/gitbucket-ci-plugin-assembply-x.x.x.jar to ~/.gitbucket/plugins/ (If the directory does not exist, create it by hand before copying the jar), or just run sbt install.

Release Notes


  • Some CircleCI compatible Web API


  • Build branches even other than the default branch
  • Support the use of an arbitrary file in the git repository as a build script


  • Max parallel builds and max stored history became configurable


  • update for Scalatra 2.6
  • fix skipping pull request build bug


  • build workspace browser
  • altered build directories location


  • skip build by commit message
  • re-run build by pull request comment
  • supply environment variables in build script


  • build status badge
  • fix pull request build bug


  • First release