Skip to content

GitLab

Package Registry

Moved to GitLab Core in 13.3.

With the GitLab Package Registry, you can use GitLab as a private or public registry for a variety of common package managers. You can publish and share packages, which can be easily consumed as a dependency in downstream projects.

View packages

You can view packages for your project or group.

  1. Go to the project or group.
  2. Go to {package} Packages & Registries > Package Registry.

You can search, sort, and filter packages on this page.

For information on how to create and upload a package, view the GitLab documentation for your package type.

Use GitLab CI/CD to build packages

You can use GitLab CI/CD to build packages. For Maven, NuGet, NPM, Conan, and PyPI packages, and Composer dependencies, you can authenticate with GitLab by using the CI_JOB_TOKEN.

CI/CD templates, which you can use to get started, are in this repo.

Learn more about using CI/CD to build Maven packages, NPM packages, Composer packages, NuGet Packages, Conan Packages, and PyPI packages.

If you use CI/CD to build a package, extended activity information is displayed when you view the package details:

Package CI/CD activity

When using Maven and NPM, you can view which pipeline published the package, as well as the commit and user who triggered it.

Download a package

To download a package:

  1. Go to {package} Packages & Registries > Package Registry.
  2. Click the name of the package you want to download.
  3. In the Activity section, click the name of the package you want to download.

Delete a package

You cannot edit a package after you publish it in the Package Registry. Instead, you must delete and recreate it.

To delete a package, you must have suitable permissions.

You can delete packages by using the API or the UI.

To delete a package in the UI, from your group or project:

  1. Go to {package} Packages & Registries > Package Registry.
  2. Find the name of the package you want to delete.
  3. Click Delete.

The package is permanently deleted.

Disable the Package Registry

The Package Registry is automatically enabled.

If you are using a self-managed instance of GitLab, your administrator can remove the menu item, {package} Packages & Registries, from the GitLab sidebar. For more information, see the administration documentation.

You can also remove the Package Registry for your project specifically:

  1. In your project, go to Settings > General.
  2. Expand the Visibility, project features, permissions section and disable the Packages feature.
  3. Click Save changes.

The {package} Packages & Registries > Package Registry entry is removed from the sidebar.

Package workflows

Learn how to use the GitLab Package Registry to build your own custom package workflow.