Bitbucket changed their UI so I refreshed this doc to reflect it
1.9 KiB
Authenticating to Bitbucket with GitHub Desktop
Creating a Personal Access Token in Bitbucket
To authenticate against Bitbucket repositories you will need to create a personal access token.
-
Go to your Bitbucket account and select Personal Bitbucket settings in the settings dropdown.
-
Select App passwords
-
Under App passwords click Create app password
-
Under the Details section in Add app password enter a label for your password
-
Under Permissions select
Read
andWrite
in the Repositories section to ensure that GitHub Desktop has the correct read/write access to your Bitbucket repositories. -
Click Create to create a new token, and then copy the token to your clipboard.
Cloning your Bitbucket repository in GitHub Desktop
-
Open GitHub Desktop and go to File > Clone Repository > URL. Enter the Git URL of your Bitbucket repository. Make sure you enter the correct URL, which should have the following structure:
https://bitbucket.com/<username>/<repository>
-
You will receive an
Authentication Failed
error. Enter your Bitbucket username and paste in the token you just copied to your clipboard as your password. Click Save and Retry to successfully clone the repository to your local machine in GitHub Desktop.
- Note: Your Bitbucket credentials will be securely stored on your local machine so you will not need to repeat this process when cloning another repository from Bitbucket.