debian-mirror-gitlab/doc/user/packages/package_registry/index.md

stage	group	info
Package	Package	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Package Registry (FREE)

Moved from GitLab Premium to GitLab Free in 13.3.

With the GitLab Package Registry, you can use GitLab as a private or public registry for a variety of supported package managers. You can publish and share packages, which can be 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 Packages & Registries > Package Registry.

You can search, sort, and filter packages on this page. You can share your search results by copying and pasting the URL from your browser.

You can also find helpful code snippets for configuring your package manager or installing a given package.

When you view packages in a group:

• All projects published to the group and its projects are displayed.
• Only the projects you can access are displayed.
• If a project is private, or you are not a member of the project, it is not displayed.

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

Authenticate with the registry

Authentication depends on the package manager being used. For more information, see the docs on the specific package format you want to use.

For most package types, the following credential types are valid:

• Personal access token: authenticates with your user permissions. Good for personal and local use of the package registry.
• Project deploy token: allows access to all packages in a project. Good for granting and revoking project access to many users.
• Group deploy token: allows access to all packages in a group and its subgroups. Good for granting and revoking access to a large number of packages to sets of users.
• Job token: allows access to packages in the project running the job for the users running the pipeline. Access to other external projects can be configured.

Use GitLab CI/CD to build packages

You can use GitLab CI/CD to build packages. For Maven, NuGet, npm, Conan, Helm, 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 repository.

Learn more about using the GitLab Package Registry with CI/CD:

• Composer
• Conan
• Generic
• Maven
• npm
• NuGet
• PyPI
• RubyGems

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

You can view which pipeline published the package, and the commit and user who triggered it. However, the history is limited to five updates of a given package.

Download a package

To download a package:

1. Go to Packages & Registries > Package Registry.
2. Select the name of the package you want to download.
3. In the Activity section, select 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 Packages & Registries > Package Registry.
2. Find the name of the package you want to delete.
3. Click Delete.

The package is permanently deleted.

Delete files associated with a package

To delete package files, you must have suitable permissions.

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

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

1. Go to Packages & Registries > Package Registry.
2. Find the name of the package you want to delete.
3. Select the package to view additional details.
4. Find the name of the file you would like to delete.
5. Expand the ellipsis and select Delete file.

The package files are 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, 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 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:

• Use a project as a package registry to publish all of your packages to one project.

• Publish multiple different packages from one monorepo project.

Supported package managers

WARNING: Not all package manager formats are ready for production use. To view each format's status, see the table's Status column.

The Package Registry supports the following formats:

Package type	GitLab version	Status
Maven	11.3+	GA
npm	11.7+	GA
NuGet	12.8+	GA
PyPI	12.10+	GA
Generic packages	13.5+	GA
Composer	13.2+	Beta
Conan	12.6+	Beta
Helm	14.1+	Beta
Debian	14.2+	Alpha
Go	13.1+	Alpha
Ruby gems	13.10+	Alpha

Status:

• Alpha: behind a feature flag and not officially supported.
• Beta: several known issues that may prevent expected use.
• GA (Generally Available): ready for production use at any scale.

You can also use the API to administer the Package Registry.

Accepting contributions

This table lists unsupported package manager formats that we are accepting contributions for. Consider contributing to GitLab. This development documentation guides you through the process.

Format	Status
Chef	#36889
CocoaPods	#36890
Conda	#36891
CRAN	#36892
Opkg	#36894
P2	#36895
Puppet	#36897
RPM	#5932
SBT	#36898
Swift	#12233
Vagrant	#36899