JetBrains CodeCanvas 2024.2 Help

Connect Bitbucket Repository

  1. Select Namespaces in the header navigation, then in the sidebar menu, select the namespace you need.

  2. In the sidebar namespace menu, select Repositories.

  3. Click New connection.

  4. Provide repository Name and other settings:

    • Remote repository URL – the SSH or HTTPS URL of the repository, e.g., git@bitbucket.org:MyCompany/my-project.git or https://bitbucket.org/MyCompany/my-project.git

    • Repository web URL – the URL of the remote repository's web interface. CodeCanvas will show this link in the repository list. For example, this can be a link to the project's README file on Bitbucket.

    • Read restrictions – specify who is allowed to view repository contents: Only selected users or All users.

      In the case of Only selected users, you should synchronize this list with your Git hosting service. Learn more

  5. If the repository doesn't require authentication, leave Anonymous in Authentication. Otherwise, choose either SSH (for SSH authentication) or Password (for HTTPS authentication).

    For SSH authentication, you need to provide an SSH key pair. CodeCanvas will use the private key only to clone the repository into dev environments. Users will be required to specify their own SSH key to pull from and push to the repository.

    1. First, generate a new SSH key pair for CodeCanvas on your local machine using:

      ssh-keygen -t ed25519

      Protect the private key with a passphrase if desired. You will have files such as mykey (private key) and mykey.pub (public key).

    2. On Bitbucket, go to Repository settings | Access keys and click Add key. Paste the contents of the public key file (mykey.pub) and click Add SSH key.

      Bitbucket add deploy key
    3. In CodeCanvas, in the Authentication field, select SSH and provide the private key (mykey) and the passphrase if set.

      Add private key. Bitbucket repo
    1. On Bitbucket, open Personal Bitbucket settings.

    2. On the App passwords page, click Create app password.

    3. In Repositories, select Read, create and copy the password.

      Create password in Bitbucket
    4. Specify the password in CodeCanvas as a repository Password and your Bitbucket username as Username.

  6. Test the connection first by clicking Test connection. If successful, click Connect. The repository will then be listed in the Repositories section.

Last modified: 28 August 2024