For AI agents: the complete documentation index is available at /en/llms.txt, the full documentation bundle is available at /en/llms-full.txt, and this page is available as Markdown at /en/static/gitlab.md.
  • English
  • Connect GitLab

    Applies to gitlab.com, GetGeek's Managed GitLab and other self-hosted GitLab instances. You need the Maintainer or Owner role in the project.

    You need the deploy key and the webhook address from us (see Getting started).

    1. Add the deploy key

    1. Open the project and go to Settings → Repository.
    2. Expand Deploy keys and click Add new key.
    3. Fill in:
      • Title: GetGeek Static (any name)
      • Key: the whole key from us, the line starting with ssh-ed25519
      • Grant write permissions to this key: must be unticked. We only need to read.
      • Expiration date: leave empty — otherwise builds stop working on that date.
    4. Click Add key.

    The form for a new deploy key in GitLab

    The key then appears in the list:

    The deploy key added in GitLab

    2. Add the webhook

    1. Go to Settings → Webhooks and click Add new webhook.
    2. Fill in:
      • Name: GetGeek Static (optional)
      • URL: the webhook address from us
      • Trigger: tick Push events, with All branches.
    Push events is not ticked by default

    In newer GitLab versions no event is selected when you create a webhook. If you forget Push events, the webhook is saved without an error — but it never sends anything, and nothing gets built.

    The webhook form in GitLab with Push events ticked

    Hide the key in the address

    Click + Add URL masking below the URL field and mask the last part of the address (after /hook/<site>/). It is then shown as {token} in GitLab, even to others with access to the project's settings.

    1. Leave Enable SSL verification ticked and click Add webhook.

    SSL verification and the Add webhook button

    3. Test

    In the list of webhooks, click Test → Push events. A green message at the top of the page means we have received the request and started a build.

    The webhook in the list, with the masked address and the Test button

    If you get an error message instead, see Troubleshooting.