> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Koppla GitLab

Gäller både gitlab.com, GetGeeks [Managed GitLab](https://getgeek.se/) och andra
egna GitLab-instanser. Du behöver rollen _Maintainer_ eller _Owner_ i projektet.

Du behöver deploynyckeln och webhook-adressen från oss
(se [Kom igång](/static/kom-igang.md#steg-2-det-har-far-du-av-oss)).

## 1. Lägg in deploynyckeln \{#1-lagg-in-deploynyckeln}

1. Öppna projektet och gå till **Settings → Repository**.
2. Fäll ut **Deploy keys** och klicka **Add new key**.
3. Fyll i:
   - **Title:** `GetGeek Static` (valfritt namn)
   - **Key:** hela nyckeln från oss, raden som börjar med `ssh-ed25519`
   - **Grant write permissions to this key:** _ska vara urkryssad._ Vi behöver
     bara läsa.
   - **Expiration date:** lämna tomt — annars slutar byggena fungera det datumet.
4. Klicka **Add key**.

![Formuläret för en ny deploynyckel i GitLab](/_assets/image/gitlab-deploykey-formular.93ab060cdf.png)
Nyckeln syns sedan i listan:

![Deploynyckeln tillagd i GitLab](/_assets/image/gitlab-deploykey-tillagd.c176f90e4b.png)
## 2. Lägg in webhooken \{#2-lagg-in-webhooken}

1. Gå till **Settings → Webhooks** och klicka **Add new webhook**.
2. Fyll i:
   - **Name:** `GetGeek Static` (valfritt)
   - **URL:** webhook-adressen från oss
   - **Trigger:** kryssa i **Push events**, med _All branches_.

:::warning Push events är inte ikryssat från början
I nyare GitLab-versioner är ingen händelse vald när du skapar en webhook.
Glömmer du **Push events** sparas webhooken utan fel — men den skickar aldrig
något, och ingenting byggs.
:::

![Webhook-formuläret i GitLab med Push events ikryssat](/_assets/image/gitlab-webhook-formular.5788c742a9.png)
:::tip Dölj nyckeln i adressen
Klicka **+ Add URL masking** under URL-fältet och maskera den sista delen av
adressen (efter `/hook/<sajt>/`). Då visas den som `{token}` i GitLab, även för
andra med åtkomst till projektets inställningar.
:::

3. Låt **Enable SSL verification** vara ikryssad och klicka **Add webhook**.

![SSL-verifiering och knappen Add webhook](/_assets/image/gitlab-webhook-ssl.65ede14882.png)
## 3. Testa \{#3-testa}

I listan över webhooks: klicka **Test → Push events**. Ett grönt besked högst upp
på sidan betyder att vi tagit emot anropet och startat ett bygge.

![Webhooken i listan, med maskerad adress och Test-knappen](/_assets/image/gitlab-webhook-lista.ad54ccacd7.png)
Får du i stället ett felmeddelande, se [Felsökning](/static/felsokning.md#webhooken-svarar-med-fel).
