Log into or connect to Bitbucket Cloud

The following methods can be used for authenticating with Bitbucket Cloud:

• If you’re logging into Bitbucket in a web browser, use your Atlassian account login credentials.

• If you’re using the Git CLI (git), use a personal SSH key.

• If you require access to a single repository, project, or workspace for scripting, CI/CD tools, Bitbucket Cloud apps, or Bitbucket Cloud integrations, use a Repository, Project, or Workspace Access Token.

• If you require read-only SSH access to a repository or project for scripting, CI/CD tools, or integrations, use repository and project Access keys.

• If you require user-level access for scripting, CI/CD tools, Bitbucket Cloud apps, or Bitbucket Cloud integrations, use App passwords.

• If you’re developing a Bitbucket Cloud app or integration, improve your user’s experience by configuring OAuth.

Atlassian account login credentials

Use your login credentials to log into https://bitbucket.org and other Atlassian products using your web browser. These login credentials can be either:

• an email and a password.

• a login from a third-party provider such as Google or Microsoft.

If you're not logging into https://bitbucket.org using a web browser, you'll need to use one of the other methods described on this page.

For information on Atlassian accounts, read:

• Atlassian Support — What is an Atlassian account?

• Atlassian Support — Log in to your Atlassian account

Personal SSH keys

Personal SSH keys are used for connecting to Bitbucket using the Git command line interface (git). These SSH keys are suitable for everyday usage of Git. An SSH key may need to be configured to use Bitbucket Cloud with some Git GUI (graphical user interface) apps (where the Git GUI app does not connect through a web browser dialog) such as Git Extensions and TortoiseGit.

If a read-only Access key is suitable; for example, in a CI/CD tool that only uses Git to clone or pull code, use repository and project Access keys.

To set up a Personal SSH key, read:

• Set up personal SSH keys on macOS

• Set up personal SSH keys on Windows

• Set up personal SSH keys on Linux

Repository, Project, and Workspace Access Tokens

Access Tokens are single-purpose access tokens (or passwords) with access to a single repository, project, or workspace. These Access Tokens can be useful for scripting, CI/CD tools, and testing Bitbucket apps and integrations while in development. For details, see Access Tokens.

Repository and project Access keys

SSH-based repository and project Access keys are used for connecting to Bitbucket using the Git command line interface (git), and provide read-only access to the repository or project they're created for. These Access keys are useful where read-only SSH access to Bitbucket is required for scripts and automation tools (including CI/CD tools).

To create an SSH-based Access key for a single Bitbucket repository, read how to:

• Set up Repository Access keys on macOS

• Set up Repository Access keys on Windows

• Set up Repository Access keys on Linux

To create an SSH-based Access key for all the repositories in a Bitbucket project, read how to:

• Set up Project Access keys on macOS

• Set up Project Access keys on Windows

• Set up Project Access keys on Linux

App passwords

App passwords are single-purpose access tokens with reduced user access. These passwords can be useful for scripting, CI/CD tools, and testing Bitbucket-connected applications while they're in development. They're sometimes required by third-party applications to connect to Bitbucket Cloud. For details, see App passwords.

OAuth

OAuth is a method of authentication used for connecting third-party apps to Bitbucket Cloud, such as Sourcetree and the Visual Studio Code Jira and Bitbucket extension. Users who are logged into Bitbucket are prompted to authorize access to specific information on Bitbucket. To learn about app development with Bitbucket APIs and OAuth, visit: Atlassian Developer — Getting started.