Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Follow the steps below to configure your Iguana X Git settings with Bitbucket.

In Iguana X, go to Settings > Git. For each step, click on the Screen Shot 2024-04-16 at 10.36.28 AM.png button to set your configurations.

 If you don't have a bitbucket account and want to use it, create a free account!

If you want to create a free Bitbucket Account, follow these steps: Creating a Free Bitbucket Account

 STEP 1: Author Info - Enter a name and email to be used to label your commits

Git requires a name and email to label your commits. We recommend you use an email address recognized by Bitbucket so you can trace your commits in it.

Screen Shot 2024-04-15 at 1.20.49 PM.png

We also use this Author Info to help Identify your Iguana so if you have problems we can help you!

 STEP 2: Cloud Username - Enter your Bitbucket Username (find it in your Bitbucket personal settings)

Enter your Bitbucket Username. If you don’t know what that is, you can follow the link in the Set Cloud Username window to navigate to your Bitbucket Personal Settings and view your Username.

Screen Shot 2024-04-15 at 3.53.22 PM.png
 STEP 3: Cloud Service - Choose Bitbucket

Select Bitbucket from the dropdown.

Screen Shot 2024-04-15 at 4.06.04 PM.png
 STEP 4: Cloud Token - In Bitbucket, generate an App Password for Iguana to authenticate

Iguana X needs to have the ability to create Git repositories on Bitbucket. This means we need to create an App password with the correct permissions. Iguana will use your Bitbucket Username and App Password to authenticate with Bitbucket.

  • In Iguana’s Set Cloud Token window, click on the link provided to create an App Password in your Bitbucket account.

  • In Bitbucket, provide a Label for your App Password and grant the following Permissions. Click Create.

  • Copy the generated Bitbucket App Password and paste it in your Iguana X Git Cloud Token setting. Bitbucket will only show you this once - if you forget it you will need to generate a fresh one.

Screen Shot 2024-04-15 at 3.53.59 PM.png
 STEP 5: Key Pair SSH - Generate a public-private key pair for SSH authentication with Bitbucket

In Key Pair SSH window, use the Generate button to have Iguana generate a private key pair for you. For more information on SSH see: How does Iguana X use SSH?

Screen Shot 2024-04-15 at 2.31.27 PM.png
 STEP 6: Cloud SSH - Register your public key with your Bitbucket

In Cloud SSH, click Register to have Iguana register your public key with Bitbucket.

Screen Shot 2024-04-15 at 2.42.31 PM.png

IguanaX failed to register ssh key? See this page: Updating Bitbucket ssh Host Key

Otherwise, All done!

You can see the registered public key in Bitbucket Personal Settings > SSH Keys.

  • No labels