Axiom Refract + GitLab

Analyze GitLab repositories — self-managed or SaaS — with full support for private projects and groups

How It Works

1

Generate a GitLab Access Token

Create a personal access token or project access token in GitLab with read_repository scope. This token allows Axiom to clone your repositories for analysis.

2

Configure Repository Access

Provide the GitLab repository URL and access token in the Axiom dashboard. Axiom supports both gitlab.com (SaaS) and self-managed GitLab instances.

3

Trigger Analysis

Submit the repository for scanning via the Axiom dashboard or REST API. The analysis pipeline clones, parses, and analyzes the full repository.

4

Access Deliverables

Review the architectural record through the dashboard, download reports, or integrate with your GitLab CI/CD pipeline for automated scanning.

What You Can Do

Self-Managed Instance Support

Axiom connects to self-managed GitLab instances in addition to gitlab.com. Provide your instance URL and an access token with appropriate scope.

Group-Level Scanning

Scan multiple projects within a GitLab group. Analyze the architectural relationships across projects that share code or dependencies.

GitLab CI/CD Pipeline Integration

Add Axiom scanning as a CI/CD pipeline stage using the REST API. Gate merge requests on architectural quality metrics.

Subgroup and Fork Support

Analyze projects in nested subgroups and forked repositories. Axiom follows the GitLab project hierarchy for access resolution.

Setup

Generate a personal access token in GitLab (Settings > Access Tokens) with read_repository scope. In the Axiom dashboard, create a new scan and provide the repository URL and access token. For self-managed instances, ensure your GitLab instance is accessible from the internet or configure network access accordingly.

# Scan a GitLab repository via REST API
curl -X POST https://axiomrefract.com/api/v1/jobs \
  -H "Content-Type: application/json" \
  -d '{
    "repo_source": "https://gitlab.com/your-group/your-project",
    "repo_type": "github",
    "customer_id": "your-customer-id"
  }'

# For self-managed GitLab, use your instance URL:
# "repo_source": "https://gitlab.yourcompany.com/group/project"

Why This Matters

Many enterprises and organizations use GitLab for their Git hosting — both the SaaS offering and self-managed instances. Axiom Refract connects to GitLab repositories with the same depth of analysis available for GitHub, ensuring architectural governance is accessible regardless of your Git hosting platform.

Read the Docs →