Skip to content

Commit 9be58df

Browse files
tricktronchmouel
authored andcommitted
docs: Document Bitbucket license requirement for groups
Bitbucket Datacenter requires service account users to have `LICENSED_USER` permission for group-based access checks. Without it, users with group-only permissions cannot trigger builds.
1 parent 3860bf3 commit 9be58df

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

docs/content/docs/install/bitbucket_datacenter.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,17 @@ After following the [installation](/docs/install/installation):
1616

1717
The token will need to have the `PROJECT_ADMIN` and `REPOSITORY_ADMIN` permissions.
1818

19+
{{< hint info >}}
20+
21+
The service account user that owns the token must be a **licensed Bitbucket
22+
user** (i.e., granted the `LICENSED_USER` global permission) for group-based
23+
permission checks to work. If the service account is an unlicensed technical
24+
user, group membership cannot be resolved and users with group-only access
25+
will not be able to trigger builds. As a workaround, add those users
26+
individually to the project or repository permissions.
27+
28+
{{< /hint >}}
29+
1930
Note that the token needs to be able to have access to the forked repository in
2031
pull requests, or it would not be able to process and access the pull request.
2132

0 commit comments

Comments
 (0)