---
id: pulumi-gitlab
version: "10.1.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pulumi-gitlab — A Pulumi package for creating and managing GitLab resources.

License: permissive · Maintenance: active · Downloads: 122.5K/mo

## What it is and what it does

pulumi-gitlab is a Pulumi resource provider that bridges Pulumi's infrastructure-as-code framework with GitLab's API, allowing you to define and manage GitLab resources programmatically. Instead of clicking through the GitLab UI or writing shell scripts, you write Python (or other Pulumi-supported languages) to declare GitLab projects, groups, users, CI/CD pipelines, and other resources as part of your infrastructure definition.

The package wraps GitLab's REST API and exposes it through Pulumi's strongly-typed resource model. It requires the Pulumi CLI and a GitLab personal access token for authentication, and supports both GitLab.com and self-hosted GitLab instances (CE and Enterprise) via optional baseUrl and certificate configuration. It's maintained actively and has low installation friction—just a pip install and four lightweight runtime dependencies.

Use it for:

- Automate GitLab project and group creation as part of a multi-cloud infrastructure deployment.
- Manage GitLab CI/CD pipeline configuration and runner registration alongside application infrastructure.
- Provision GitLab users and access controls in bulk for new teams or organizations.
- Version-control your GitLab configuration (projects, webhooks, variables) in the same repository as your infrastructure code.
- Destroy and recreate GitLab resources programmatically during testing or ephemeral environment teardown.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Pulumi provider for GitLab that lets you define and manage GitLab resources (projects, users, groups, CI/CD pipelines, etc.) as code using Pulumi's infrastructure-as-code framework.

Yes, if you use Pulumi for infrastructure-as-code and need to manage GitLab resources alongside your cloud infrastructure. The package is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. Install only if you're already committed to Pulumi; it's not a standalone GitLab client.

## Install

pip install pulumi-gitlab
uv add pulumi-gitlab
poetry add pulumi-gitlab

## Installing pulumi-gitlab

Before you install: Low friction installation with a pure Python wheel. Depends on pulumi, parver, semver, and typing-extensions—all standard, lightweight libraries. Repository is active with a recent commit on 2026-08-14 and no archived status, suggesting ongoing maintenance.

License in practice: Licensed under Apache-2.0 (permissive), so you can use, modify, and distribute this package freely in commercial and private projects without copyleft obligations.

Quickstart:

pip install pulumi_gitlab

import pulumi
import pulumi_gitlab as gitlab

project = gitlab.Project('my-project', name_prefix='test')

Requires Pulumi CLI to be installed first and a GitLab personal access token (via GITLAB_TOKEN environment variable or configuration).

Verify before relying:

- Exact count of GitLab resource types supported by this provider version.
- Whether self-hosted GitLab instances are fully supported or have known limitations.
- Performance characteristics when managing large numbers of GitLab resources.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 122.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pulumi gitlab provider, infrastructure as code gitlab, gitlab resource management, pulumi cloud automation, gitlab api automation, declarative gitlab provisioning, pulumi infrastructure provider, infrastructure-as-code, gitlab-automation, pulumi-provider

[View on SkillFed](https://skillfed.io/packages/pulumi-gitlab) · [View on PyPI](https://pypi.org/project/pulumi-gitlab/)