Overview

To integrate CodeAnt AI with your self-hosted GitLab instance, you’ll need to create a GitLab OAuth application. This OAuth application enables CodeAnt AI to authenticate users and access repositories securely.

Prerequisites

  • Administrative access to your self-hosted GitLab instance

Step 1: Create GitLab OAuth Application

Access Application Settings

  1. Log into your self-hosted GitLab instance
  2. Click your profile avatar in the top-left corner
  3. Select Edit Profile from the dropdown menu

  1. In the left sidebar, navigate to Applications
  2. Click Add new application

Configure Application Details

  1. Application Name: Enter a descriptive name (e.g., “CodeAnt AI Integration”)

  2. Redirect URI: Enter the following URL:

    https://app.codeant.ai
  3. Scopes: Select the following required permissions:

    • api - API access
    • read_api - Read API access
    • read_user - Read user information
    • write_repository - Write repository access
    • profile - Read user profile

  1. Click Save application

Record Credentials

After creating the application, you’ll see the Application ID and Secret. Important: Copy and securely store both values as you’ll need them for the CodeAnt AI configuration.

Step 2: Configure CodeAnt AI

Initial Setup

  1. Navigate to app.codeant.ai
  2. Select Self-Hosted option
  3. Choose Self-Hosted GitLab as your provider

Enter Configuration Details

Provide the following information from your GitLab setup:

  • Base URL: Your GitLab instance URL (e.g., https://gitlab.yourcompany.com)
  • Application ID: The Application ID from Step 1
  • Secret: The Secret from Step 1

  1. Click Submit to save the configuration

Step 3: Complete Authentication

  1. Return to the self-hosted options in CodeAnt AI
  2. Select Self-Hosted GitLab again
  3. Click Login and enter your GitLab base URL when prompted
  4. You’ll be redirected to your GitLab instance for authentication
  5. After successful authentication, you should see your repositories in CodeAnt AI

Troubleshooting

If you encounter issues during setup:

  • Verify that all required scopes are selected in your GitLab OAuth application
  • Ensure the redirect URI exactly matches https://app.codeant.ai
  • Check that your GitLab instance is accessible from the internet
  • Confirm that the Application ID and Secret are copied correctly

For additional support, contact the CodeAnt AI team or refer to our comprehensive documentation.