Skip to content

GitLab Self-Managed Integration

Connect your GitLab Self-Managed repositories to Capawesome Cloud to streamline your workflow for Live Updates and Native Builds. This integration allows Capawesome Cloud to access your source code from your self-hosted GitLab instance and automate deployments directly from your repository.

Prerequisites

Before you begin, ensure you have:

  • A Capawesome Cloud account with an app created.
  • Access to a GitLab Self-Managed instance.

Create a personal access token

To connect your GitLab Self-Managed instance to Capawesome Cloud, you need to create a personal access token with the appropriate permissions:

  1. Log in to your GitLab Self-Managed instance.
  2. In the upper-right corner, click on your avatar and select Preferences.
  3. In the left sidebar, select Personal access tokens.
  4. Click the Add new token button.
  5. Enter a descriptive name for the token (e.g., "Capawesome Cloud").
  6. Set an expiration date for the token (optional, but recommended for security).
  7. Select the following scopes: read_api, read_user and read_repository.
  8. Click Create personal access token.
  9. Copy the generated token immediately and store it securely. You will not be able to see it again.

You will use this token when connecting your GitLab Self-Managed instance to Capawesome Cloud in the next step.

Connect your repository

To connect your GitLab Self-Managed repository to Capawesome Cloud, follow these steps:

  1. Navigate to the Git page in the Capawesome Cloud Console.
  2. Click on the GitLab tab in the Git Providers section.
  3. A dialog will appear prompting you to enter your GitLab Self-Managed instance URL and token. Fill in the required information and click Connect.
  4. After connecting, select GitLab Self-Managed as your Git provider within the Git Repositories section.
  5. Choose an owner (group) and select the repository you want to connect to Capawesome Cloud.
  6. Click the Save button to finalize the integration.

Your GitLab Self-Managed repository is now connected to Capawesome Cloud.