Skip to main content
Version: 3.4.x

Bitbucket Datacenter / Server

warning

Woodpecker comes with experimental support for Bitbucket Datacenter / Server, formerly known as Atlassian Stash.

To enable Bitbucket Server you should configure the Woodpecker container using the following environment variables:

docker-compose.yaml
 services:
   woodpecker-server:
     [...]
     environment:
       - [...]
+      - WOODPECKER_BITBUCKET_DC=true
+      - WOODPECKER_BITBUCKET_DC_GIT_USERNAME=foo
+      - WOODPECKER_BITBUCKET_DC_GIT_PASSWORD=bar
+      - WOODPECKER_BITBUCKET_DC_CLIENT_ID=xxx
+      - WOODPECKER_BITBUCKET_DC_CLIENT_SECRET=yyy
+      - WOODPECKER_BITBUCKET_DC_URL=http://stash.mycompany.com

   woodpecker-agent:
     [...]

Service Account​

Woodpecker uses git+https to clone repositories, however, Bitbucket Server does not currently support cloning repositories with an OAuth token. To work around this limitation, you must create a service account and provide the username and password to Woodpecker. This service account will be used to authenticate and clone private repositories.

Registration​

Woodpecker must be registered with Bitbucket Datacenter / Server. In the administration section of Bitbucket choose "Application Links" and then "Create link". Woodpecker should be listed as "External Application" and the direction should be set to "Incoming". Note the client id and client secret of the registration to be used in the configuration of Woodpecker.

See also Configure an incoming link.

Configuration​

This is a full list of configuration options. Please note that many of these options use default configuration values that should work for the majority of installations.

BITBUCKET_DC​

  • Name: WOODPECKER_BITBUCKET_DC
  • Default: false

Enables the Bitbucket Server driver.

BITBUCKET_DC_URL​

  • Name: WOODPECKER_BITBUCKET_DC_URL
  • Default: none

Configures the Bitbucket Server address.

BITBUCKET_DC_CLIENT_ID​

  • Name: WOODPECKER_BITBUCKET_DC_CLIENT_ID
  • Default: none

Configures your Bitbucket Server OAUth 2.0 client id.

BITBUCKET_DC_CLIENT_SECRET​

  • Name: WOODPECKER_BITBUCKET_DC_CLIENT_SECRET
  • Default: none

Configures your Bitbucket Server OAUth 2.0 client secret.

BITBUCKET_DC_GIT_USERNAME​

  • Name: WOODPECKER_BITBUCKET_DC_GIT_USERNAME
  • Default: none

This username is used to authenticate and clone all private repositories.

BITBUCKET_DC_GIT_USERNAME_FILE​

  • Name: WOODPECKER_BITBUCKET_DC_GIT_USERNAME_FILE
  • Default: none

Read the value for WOODPECKER_BITBUCKET_DC_GIT_USERNAME from the specified filepath

BITBUCKET_DC_GIT_PASSWORD​

  • Name: WOODPECKER_BITBUCKET_DC_GIT_PASSWORD
  • Default: none

The password is used to authenticate and clone all private repositories.

BITBUCKET_DC_GIT_PASSWORD_FILE​

  • Name: WOODPECKER_BITBUCKET_DC_GIT_PASSWORD_FILE
  • Default: none

Read the value for WOODPECKER_BITBUCKET_DC_GIT_PASSWORD from the specified filepath

BITBUCKET_DC_SKIP_VERIFY​

  • Name: WOODPECKER_BITBUCKET_DC_SKIP_VERIFY
  • Default: false

Configure if SSL verification should be skipped.