Configure Bitbucket Posting User

Code reviews for your Bitbucket Server repositories will be posted as a "PullRequest" member of your Bitbucket team. In order to post code reviews, the user must be added in Bitbucket.

This must be done by an individual with the following:

• A PullRequest account with an Owner role for the organization in question.
• An Admin role on your Bitbucket Server instance.

1. Log into the PullRequest Proxy and click the Configure Bitbucket button on the home page.
   
   
   
   
   
   
2. Paste the root URL of your Bitbucket Server instance (this will be whatever domain your team usually uses to access Bitbucket). Example:

   https://our-bitbucket.internal

3. Log in to your Bitbucket instance as an admin and create a new user with the username PullRequest. This will be the user that posts comments in your repositories.
   
   
4. Add the PullRequest user to all of the repositories you want code review on. Be sure to grant the user WRITE permission so it's able to post comments.
   NOTE: PullRequest will never write or modify code in your repositories.
   
   
5. Log in to Bitbucket as the PullRequest user - this is required for creating a personal access token.
   NOTE: This may be easier in another browser or an incognito tab so you can remain logged in as the Bitbucket admin user).
   
   
6. Create a personal access token for the PullRequest user in Bitbucket by opening https://our-bitbucket.internal/plugins/servlet/access-tokens/manage in the browser you were logged into as the PullRequest user.
   • The access token will need to have Projects READ and Repositories WRITE permissions.
     
     
     
     
7. Copy this personal access token to your clipboard and go back to the PullRequest Proxy UI with the Bitbucket Settings modal open.
   
   
8. Enter PullRequest as the PullRequest Username (or whatever name was used in Bitbucket).
   
   
9. Paste the personal access token into the modal and click Update.
   
   
   
   
10. Now open the Repositories tab in the left sidebar. The repositories the PullRequest Bitbucket user were added to should appear in a list here.
    
    
    

NEXT: Configure Bitbucket Webhooks