> ## Documentation Index
> Fetch the complete documentation index at: https://honeydew.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

You can onboard using your own GitLab repository.
If you would like to use your own GitLab repository, please complete the following steps:

<Steps>
  <Step title="Create a GitLab Repository">
    Create a new **GitLab** private repository using one of these options:

    * Create a new repository
    * Clone from the [Honeydew quick-start](https://gitlab.com/honeydew-ai/honeydew-quickstart) example.
  </Step>

  <Step title="Configure allowed IP addresses">
    If you are restricting access to your GitLab group using IP addresses allow list,
    add the IP addresses displayed in the GitLab connection screen in [Honeydew App settings page](https://app.honeydew.cloud/settings)
    to the restricted IP addresses list in your GitLab group settings.

    <Note>
      For the Honeydew Cloud deployment, the following IP addresses are used:

      * `34.86.209.90`
      * `34.145.147.92`

      If you are using a private Honeydew deployment, the IP addresses will be different.
      You can find them in the GitLab connection screen in [Honeydew App settings page](https://app.honeydew.cloud/settings).
    </Note>
  </Step>

  <Step title="Set up Honeydew">
    Please reach out to [support@honeydew.ai](mailto:support@honeydew.ai) and send the full repository name - `org-name/repository-name` (e.g. `honeydew-ai/honeydew-quickstart`).
  </Step>

  <Step title="Create a GitLab Token">
    Create a new **GitLab** token for Honeydew integration:

    * In **GitLab**, under the project you have created for Honeydew, go to **Settings** -> **Access tokens**
    * Create a new project token:
      * Select `Maintainer` as the role
      * Set the following permissions:
        * `api`
        * `read_user`
        * `read_repository`
        * `write_repository`
      * Set a far-enough expiration date
      * Name the token (e.g. `Honeydew`)
  </Step>

  <Step title="Configure the token in Honeydew">
    In the Honeydew application, go to **Settings** -> **GitLab** and configure the token.
  </Step>
</Steps>

<Tip>
  If you have branch rules, push rules or merge request rules for new repositories, you may need to relax these rules for the Honeydew GitLab repository.
  Specifically, please disable Merge request approval rules requiring at least one reviewer for merge requests.
</Tip>