Bitbucket access token
Bitbucket Cloud
Git Town can interact with Bitbucket Cloud in your name, for example to update pull requests as branches get created, shipped, or deleted, or to ship pull requests. To do so, Git Town needs your Bitbucket username and a Bitbucket app password.
An app password is not the password of your Bitbucket account. It’s a special
password that you create so that external applications can interact with
Bitbucket in your name. To create an app password in the Bitbucket web UI, click
on the Settings cogwheel, choose Personal Bitbucket settings, and then in
the menu on the left App passwords. You need to enable these permissions:
- repository: read and write
- pull requests: read and write
Bitbucket Data Center
Git Town can interact with Bitbucket Data Center in your name. To do so, Git Town needs your Bitbucket username and an HTTP access token.
An HTTP access token is not the password of your Bitbucket account. It’s a
special password that you create so that external applications can interact with
Bitbucket in your name. To create an HTTP access token in the Bitbucket web UI,
click on your Profile picture, choose Manage account, and then in the menu on
the left HTTP access tokens. You need to enable these permissions:
- Project read
- Repository write
config file
Since your app password or access token is confidential, you cannot add it to the config file.
Git metadata
You can configure the app password or access token manually by running:
git config [--global] git-town.bitbucket-app-password <token>The optional --global flag applies this setting to all Git repositories on
your machine. Without it, the setting applies only to the current repository.