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

# GitLab

<AccordionGroup>
  <Accordion title="Prerequisites" icon="list-check">
    * An Enkryptify workspace with admin access
    * A GitLab account with Maintainer or Owner permissions on the target project
    * A Personal Access Token with the `api` scope
  </Accordion>

  <Accordion title="Permissions" icon="scroll-text">
    When connecting Enkryptify to GitLab using a Personal Access Token, we only use the permissions required to create and update CI/CD variables on your selected project:

    * Required token scope:
      * `api`: access needed by GitLab to manage project CI/CD variables via API

    > Enkryptify does not access your repository contents. The token is used solely for API calls to manage variables.
  </Accordion>
</AccordionGroup>

## Steps to complete

<Steps>
  <Step title="Create a new sync">
    * Go to the `Syncs` tab of your project and click on `GitLab`.
  </Step>

  <Step title="Provide host and Personal Access Token">
    * `Host`: leave blank to use `gitlab.com`. For self-managed, enter the full base URL, e.g. `https://gitlab.example.com`.
    * `Personal Access Token`: must include the `api` scope.
  </Step>

  <Step title="Select your GitLab project">
    * Confirm the target project (repository) where secrets will sync as CI/CD variables.
  </Step>

  <Step title="Map Enkryptify environment to GitLab environment">
    * Example: `main` → `production` or `develop` → `staging`.
  </Step>
</Steps>