Follow the steps below to configure your Iguana X Git settings with GitLab (cloud).
In Iguana X, go to Settings > Git.
| Expand |
|---|
| title | 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 |
| Expand |
|---|
| title | 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 your Git cloud host so you can trace your commits in that cloud service.  Image AddedWe also use this Author Info to help Identify your Iguana so if you have problems we can help you! |
| Expand |
|---|
| title | STEP 2: Cloud Username - Enter your Bitbucket Username (find in your Bitbucket personal settings) |
|---|
|
Enter your Bitbucket Username. If you don’t know wha that is, you can follow the link to navigate to your Bitbucket Personal Settings and view your Username.  Image Added |
| Expand |
|---|
| title | STEP 2: Cloud Service - Choose Bitbucket |
|---|
|
Select Bitbucket from the dropdown.  Image Added |
| Expand |
|---|
| title | STEP 3: Cloud Token - In GitLab, generate an access token to authenticate |
|---|
|
Iguana X needs to have the ability to create Git repos 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. Click on the link provided to create an App Password in Bitbucket. 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.
 Image Added |
| Expand |
|---|
| title | STEP 4: Key Pair SSH - Generate a public-private key pair for SSH authentication with Bitbucket |
|---|
|
In Key Pair SSH, 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?  Image Added |
| Expand |
|---|
| title | STEP 5: Cloud SSH - Register your public key with your cloud host |
|---|
|
In Cloud SSH, click Register to have Iguana register your public key with Bitbucket.  Image AddedIguanaX 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. |