This guide provides detailed instructions for integrating Factory with your self-hosted GitLab instance, allowing the Factory platform to securely access and work with your on-premise repositories.

Connecting to a self-hosted GitLab instance is only supported in the Enterprise plan.

​
Prerequisites

  • Admin access to your self-hosted GitLab instance
  • A Factory account with an Enterpise plan and admin privileges

​
Integration Process

1

Create GitLab Application

  1. In your GitLab instance, go to Admin Area > Applications.
  2. Click “Add new application” and fill in the details:
    • Name: Factory Integration
    • Redirect URI: https://app.factory.ai/api/integrations/redirect/gitlab-sh
    • Scopes:
      • api
      • read_api
      • read_user
      • read_repository
      • write_repository
      • read_observability
      • write_observability
  3. Save the application and note the Application ID and Secret.
2

Configure Gitlab Self-Hosted in Factory

  1. Navigate to https://app.factory.ai/settings/integrations, click on “Connect” next to GitLab, and toggle “Self-Hosted” in the bottom left.
  2. In the Self-Hosted Setup panel, enter your GitLab Self-Hosted Application details:
    • Domain: the url of your GitLab instance, such as https://gitlab.example.com
    • Application ID: from the application created in the previous part.
    • Secret: from the application created in the previous part.
  3. Save the configuration.
  4. Click “Manage Gitlab Self-Hosted Permissions” in the top right and “Authorize” in the pop-up window.
  5. Your repositories should now appear in the Repository Selection panel. Navigate there and enable repositories for Factory.

​
Support

For any specific issues or detailed support needs, contact the Factory team through your designated support channel.

Security and Compliance

Learn about Factory’s security measures for enterprise integrations

This guide provides detailed instructions for integrating Factory with your self-hosted GitLab instance, allowing the Factory platform to securely access and work with your on-premise repositories.

Connecting to a self-hosted GitLab instance is only supported in the Enterprise plan.

​
Prerequisites

  • Admin access to your self-hosted GitLab instance
  • A Factory account with an Enterpise plan and admin privileges

​
Integration Process

1

Create GitLab Application

  1. In your GitLab instance, go to Admin Area > Applications.
  2. Click “Add new application” and fill in the details:
    • Name: Factory Integration
    • Redirect URI: https://app.factory.ai/api/integrations/redirect/gitlab-sh
    • Scopes:
      • api
      • read_api
      • read_user
      • read_repository
      • write_repository
      • read_observability
      • write_observability
  3. Save the application and note the Application ID and Secret.
2

Configure Gitlab Self-Hosted in Factory

  1. Navigate to https://app.factory.ai/settings/integrations, click on “Connect” next to GitLab, and toggle “Self-Hosted” in the bottom left.
  2. In the Self-Hosted Setup panel, enter your GitLab Self-Hosted Application details:
    • Domain: the url of your GitLab instance, such as https://gitlab.example.com
    • Application ID: from the application created in the previous part.
    • Secret: from the application created in the previous part.
  3. Save the configuration.
  4. Click “Manage Gitlab Self-Hosted Permissions” in the top right and “Authorize” in the pop-up window.
  5. Your repositories should now appear in the Repository Selection panel. Navigate there and enable repositories for Factory.

​
Support

For any specific issues or detailed support needs, contact the Factory team through your designated support channel.

Security and Compliance

Learn about Factory’s security measures for enterprise integrations