Skip to main content

Server - GitLab Setup

Follow the steps below to configure your IguanaX Git settings to leverage your local GitLab server.

First, you need to add your local GitLab server to your Settings > Git Servers list.

STEP 1: To configure a local server, add your GitLab Server Address to the Git Servers list

See Git Servers to add your local GitLab Server.

Go to Settings > Git. For each step, click to set your configurations.

STEP 2: 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 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 3: Git Server - Choose your local GitLab server address

Select your local GitLab server address from the list of Git Servers.

STEP 4: Server Token - In GitLab, generate a personal access token and add it as a Server Token in IguanaX

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 5: 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 6: Server SSH - Register your public key with your GitLab

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.