Using BitBucket with Codenvy

Since Codenvy uses Git as the only default version control system, it is only possible to clone, push and fetch Git repositories from BitBucket. Make sure you avoid importing Mercurial BitBucket repositories.

SSH Configuration

To be able to push to BitBucket or clone repositories via SSH protocol, you should establish a secure SSH connection to your BitBucket account. To do so, first off, configure SSH key in Codenvy and save this key to your BitBucket account.

  • go to Window > Preferences > SSH Keys and press Generate Key button. Enter hostname as:
bitbucket.org

(no www or https) and click OK

  • the key will appear in the list of SSH keys. Click View and copy the key to clipboard. Make sure you’ve selected and copied the entire key text
  • go to your BitBucket profile menu in the top right corner and choose Manage account. You’ll see SSH keys in the left side menu. Press Add Key, enter the key name (e.g. Codenvy) and paste the key you have copied in Codenvy.

Clone From BitBucket

With your SSH key configured, you can clone a BitBucket repository to Codenvy – either via https or SSH protocols:

  • copy the repository URL
  • in Codenvy, go to Git > Clone Repository
  • modify your project’s name, if necessary and click Clone.

It is possible to clone private repositories via SSH protocol only!

Push to BitBucket

To push to BitBucket, you first need to add a remote repository in Codenvy at Git> Remotes > Add (unless it is already there after cloning). Enter the repository name and its SSH Git URL which should look like

git@bitbucket.org:UserName/RepositoryName.git

Having added a remote repository, you can push to BitBucket at Git > Remote > Push. The repository you have just added should appear in the list of remote repos.