Github Setup

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

In Iguana X, go to Settings > Git.

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.

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 Service - Choose GitHub

Select GitHub from the dropdown.

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

STEP 3: Cloud Token - In GitHub, generate a personal access token for Iguana to authenticate

Go to https://github.com/settings/tokens/new to create a new personal access token in Github.
Enter a Note and appropriate Expiration according to your preferences.

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

Grant the following Scopes and click Generate Token:

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

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

Copy the generated GitHub access token and paste it in your Iguana X Git Cloud Token setting.

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

STEP 4: Key Pair SSH - Generate a public-private key pair for SSH authentication

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?

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

STEP 5: Cloud SSH - Register your public key with GitHub

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

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

All Done!

You can see your registered public key in your GitHub account Settings > SSH and GPG keys (under Access)