# Integrating Your GitLab Repository


Discover how to seamlessly integrate your GitLab repository with Zerops for automated builds and deployments.

This guide walks you through the step-by-step process to link your repository, configure triggers, and manage your integrations efficiently.

---

## Prerequisites

Before starting the integration process, ensure your repository contains a valid `zerops.yaml` configuration file located in the root directory. This file is essential for defining the build, deploy, and run processes.
For detailed information on how to create or modify this file, refer to the [Zerops YAML configuration](/zerops-yaml/specification) guide.

---

## Integration Steps

Follow these steps to connect your Gitlab repository with Zerops:

1. **Access Service Settings**

   - Log into the [**Zerops GUI**](https://app.zerops.io/)
   - Select the relevant service from your dashboard.
   - In the left-hand menu, navigate to **Build, Deploy, Run Pipeline Settings**.

2. **Connect to GitLab**

   - Click **Connect with a GitLab repository**
   - You'll be prompted to authorize Zerops to access your GitLab account.
   - Grant the necessary permissions for Zerops to manage webhooks and fetch your code.

:::note
Zerops requires full access to configure webhooks and download your code. Your source code is not stored after the build process.
:::

3. **Select Repository and Trigger**

   - Choose the repository to integrate
   - Select a trigger method:
     - **New tag**: Builds trigger on new tags
       - Optionally add a regex to filter tags
     - **Push to branch**: Builds trigger on pushes to a specific branch

4. **Finalize Setup**
   - Confirm your settings to complete the integration

-->

---

### Skip the automatic pipeline once

To ensure that a pipeline is not triggered by a specific commit, add `[ci skip]` or `[skip ci]` to the commit message. It is case insensitive.

:::note
You will still see a successful delivery of a webhook in your GitLab repository as a webhook is actually triggered, but with no action.
:::

---

## Disconnecting Your Repository

To disconnect your GitLab repository from Zerops:

1. Navigate to the **Service Details** page for the relevant service
1. Select **Build, Deploy, Run Pipeline Settings** from the menu.
1. Click **Stop automatic build trigger**

**This action will remove the GitLab webhook and delete the associated integration configuration, effectively halting automated builds from this repository.**