> For the complete documentation index, see [llms.txt](https://sandgarden.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandgarden.gitbook.io/docs/getting-started/connect-gitlab.md).

# Connect GitLab

Use this page when GitLab needs to feed Doc Holiday. For the shared model behind Sources, start with [Concepts](/docs/overview/concepts.md) and [Sources](/docs/sources/sources.md). On GitLab, Doc Holiday opens merge requests (GitLab's term for pull requests) and keeps project Sources current.

### One token, many projects

1. Open **Sources**, then the **Providers** tab, and select **Add Provider**.
2. Choose **GitLab Access Token**.
3. Enter **Token Name** and **Access Token**. Select **Save Changes**.
4. Return to the **Sources** tab and select **Add Source**.
5. Choose **GitLab Project**.
6. Enter **Source Name**, **Project**, **Branch**, and **Publishing System**. Choose the project in **Project**. Doc Holiday infers the provider token from the project you pick.
7. Repeat **Add Source** for each GitLab project that should use the same token.

If you need the supported publishing systems, see [Publishing systems](/docs/publications/publishing-systems.md).

### One project with its own token

Use this option when one project needs its own token.

1. In the **Add Source** sheet with **GitLab Project** selected, select **Click here to create a source for a single project instead**.
2. Enter **Source Name**, **Access Token**, **Project**, **Branch**, and **Publishing System**.
3. Select **Save Changes**.

This form covers exactly one project, and the token stays on that Source.

### Verify

Open **Sources** and confirm that the Source shows **Healthy**. If it does not, open [Manage connections](/docs/sources/manage-connections.md).

### Next

Continue with [Create your first Publication](/docs/getting-started/create-your-first-publication.md).
