Skip to main content

Cloud - GitLab Setup

Follow the steps below to configure your IguanaX Git settings with GitLab cloud service.

In IguanaX, go to Settings > Git. For each step, click on the button to set your configurations.

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 GitLab so you can trace your commits in it.

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

STEP 2: Git Server - Choose gitlab.com

Select gitlab.com (Cloud - GitLab) from the list of Git Servers. Click Save.

STEP 3: Server Token - In GitLab, generate a personal access token for the User to authenticate

IguanaX needs to have the ability to create Git repositories on GitLab. This means we need to create an access token with the correct permissions. Iguana will use the token to authenticate with GitLab.

  • Enter a Token Name, Expiration Date and grant the following Scopes. Click Create Personal Access Token:

  • Copy the generated GitLab access token and paste it in your IguanaX Git Server Token setting and click Save. GitLab will only show you this once - if you forget it you will need to generate a fresh one.

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

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 IguanaX use SSH?

STEP 5: Server SSH - Register your public key with your cloud host

In Server SSH, click Register to have Iguana register your public key with GitLab.

You can see the registered public key in GitLab User Settings > SSH Keys.