Skip to main content

​
Overview

The GitLab integration allows AIM to automatically fetch and maintain an up-to-date catalog of repositories stored in your GitLab organization or groups.
Once connected, AIM continuously pulls:
  • Repository names
  • Visibility (public / private)
  • Default branches
  • Timestamps
  • Ownership and namespace
  • Associated metadata
This ensures your development assets remain accurately tracked inside AIM without manual importing.

​
Prerequisites

Before setting up the integration, ensure the following:
  • A GitLab account with API access
  • A Personal Access Token (PAT) with:
    • read_api
    • read_repository
  • The GitLab instance URL:
    • https://gitlab.com for cloud
    • Your custom domain for self-hosted GitLab (e.g., https://gitlab.internal.company)
AIM never requires write permissions — only read access is needed.

​
How to Connect GitLab to AIM

1

Open Integrations

Go to AIM → Integrations and locate the GitLab tile.
2

Click Install

Select Install to open the configuration modal.
3

Enter GitLab Instance URL

Provide the URL of your GitLab environment.
4

Add Your Personal Access Token

Paste your PAT with read_api permissions.
5

Save Integration

AIM will validate your credentials and begin importing repository data.

​
What AIM Syncs from GitLab

AIM automatically imports and updates:
  • Repository name
  • Namespace (user or group)
  • Description
  • Visibility (private / internal / public)
  • Repository URL
  • Last activity timestamp
  • Default branch
  • Creation & update metadata
Syncs run continuously to ensure your inventory always reflects the latest repository state.

​
Managing the Integration

After installation, you can:
  • Refresh repositories manually
  • Pause / Resume syncing
  • View sync logs to confirm import success
  • Remove the integration at any time

​
Next Steps

View Repository Catalog

Explore all GitLab repositories imported into AIM.