2020-10-24 23:57:45 +05:30
---
stage: Package
group: Package
2021-02-22 17:27:13 +05:30
info: 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
2020-10-24 23:57:45 +05:30
---
2021-04-17 20:07:23 +05:30
# Package Registry **(FREE)**
2020-10-24 23:57:45 +05:30
2021-12-11 22:18:48 +05:30
> [Moved](https://gitlab.com/gitlab-org/gitlab/-/issues/221259) from GitLab Premium to GitLab Free in 13.3.
2020-10-24 23:57:45 +05:30
2021-12-11 22:18:48 +05:30
With the GitLab Package Registry, you can use GitLab as a private or public registry for a variety
of [supported package managers ](#supported-package-managers ).
You can publish and share packages, which can be consumed as a dependency in downstream projects.
2020-10-24 23:57:45 +05:30
2022-04-04 11:22:00 +05:30
## Package workflows
Learn how to use the GitLab Package Registry to build your own custom package workflow:
- [Use a project as a package registry ](../workflows/project_registry.md )
to publish all of your packages to one project.
- Publish multiple different packages from one [monorepo project ](../workflows/working_with_monorepos.md ).
2020-10-24 23:57:45 +05:30
## View packages
You can view packages for your project or group.
1. Go to the project or group.
2022-10-11 01:57:18 +05:30
1. Go to **Packages and registries > Package Registry** .
2020-10-24 23:57:45 +05:30
2021-04-29 21:17:54 +05:30
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.
2020-10-24 23:57:45 +05:30
2021-04-17 20:07:23 +05:30
You can also find helpful code snippets for configuring your package manager or installing a given package.
2021-03-11 19:13:27 +05:30
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.
2020-10-24 23:57:45 +05:30
For information on how to create and upload a package, view the GitLab documentation for your package type.
2022-03-02 08:16:31 +05:30
## 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 ](../../profile/personal_access_tokens.md ):
authenticates with your user permissions. Good for personal and local use of the package registry.
- [Project deploy token ](../../project/deploy_tokens/index.md ):
allows access to all packages in a project. Good for granting and revoking project access to many
users.
- [Group deploy token ](../../project/deploy_tokens/index.md#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 ](../../../ci/jobs/ci_job_token.md ):
allows access to packages in the project running the job for the users running the pipeline.
Access to other external projects can be configured.
2022-08-27 11:52:29 +05:30
NOTE:
If you have not activated the "Packages" feature for your project at **Settings > General > Project features** , you will receive a 403 Forbidden response.
2022-07-23 23:45:48 +05:30
2020-10-24 23:57:45 +05:30
## Use GitLab CI/CD to build packages
2021-09-30 23:02:18 +05:30
You can use [GitLab CI/CD ](../../../ci/index.md ) to build packages.
For Maven, NuGet, npm, Conan, Helm, and PyPI packages, and Composer dependencies, you can
2020-10-24 23:57:45 +05:30
authenticate with GitLab by using the `CI_JOB_TOKEN` .
2021-03-11 19:13:27 +05:30
CI/CD templates, which you can use to get started, are in [this repository ](https://gitlab.com/gitlab-org/gitlab/-/tree/master/lib/gitlab/ci/templates ).
2020-10-24 23:57:45 +05:30
2021-09-04 01:27:46 +05:30
Learn more about using the GitLab Package Registry with CI/CD:
2020-10-24 23:57:45 +05:30
2021-09-04 01:27:46 +05:30
- [Composer ](../composer_repository/index.md#publish-a-composer-package-by-using-cicd )
- [Conan ](../conan_repository/index.md#publish-a-conan-package-by-using-cicd )
- [Generic ](../generic_packages/index.md#publish-a-generic-package-by-using-cicd )
- [Maven ](../maven_repository/index.md#create-maven-packages-with-gitlab-cicd )
- [npm ](../npm_registry/index.md#publish-an-npm-package-by-using-cicd )
- [NuGet ](../nuget_repository/index.md#publish-a-nuget-package-by-using-cicd )
2021-12-11 22:18:48 +05:30
- [PyPI ](../pypi_repository/index.md#authenticate-with-a-ci-job-token )
- [RubyGems ](../rubygems_registry/index.md#authenticate-with-a-ci-job-token )
2021-01-29 00:20:46 +05:30
If you use CI/CD to build a package, extended activity information is displayed
when you view the package details:
2020-10-24 23:57:45 +05:30
2021-02-22 17:27:13 +05:30
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.
2020-10-24 23:57:45 +05:30
2022-04-04 11:22:00 +05:30
## Reduce storage usage
2020-10-24 23:57:45 +05:30
2022-04-04 11:22:00 +05:30
For information on reducing your storage use for the Package Registry, see
[Reduce Package Registry storage use ](reduce_package_registry_storage.md ).
2021-09-04 01:27:46 +05:30
2020-10-24 23:57:45 +05:30
## Disable the Package Registry
The Package Registry is automatically enabled.
If you are using a self-managed instance of GitLab, your administrator can remove
2022-10-11 01:57:18 +05:30
the menu item, **Packages and registries** , from the GitLab sidebar. For more information,
2020-10-24 23:57:45 +05:30
see the [administration documentation ](../../../administration/packages/index.md ).
You can also remove the Package Registry for your project specifically:
1. In your project, go to **Settings > General** .
1. Expand the **Visibility, project features, permissions** section and disable the
**Packages** feature.
2022-07-23 23:45:48 +05:30
1. Select **Save changes** .
2020-10-24 23:57:45 +05:30
2022-10-11 01:57:18 +05:30
The **Packages and registries > Package Registry** entry is removed from the sidebar.
2020-10-24 23:57:45 +05:30
2022-06-21 17:19:12 +05:30
## Package Registry visibility permissions
[Project-level permissions ](../../permissions.md )
determine actions such as downloading, pushing, or deleting packages.
The visibility of the Package Registry is independent of the repository and can't be controlled from
your project's settings. For example, if you have a public project and set the repository visibility
to **Only Project Members** , the Package Registry is then public. However, disabling the Package
Registry disables all Package Registry operations.
[GitLab-#329253 ](https://gitlab.com/gitlab-org/gitlab/-/issues/329253 )
2022-07-23 23:45:48 +05:30
proposes adding the ability to control Package Registry visibility from the UI.
2022-06-21 17:19:12 +05:30
| | | Anonymous< br / > (everyone on internet) | Guest | Reporter, Developer, Maintainer, Owner |
| -------------------- | --------------------- | --------- | ----- | ------------------------------------------ |
| Public project with Package Registry enabled | View Package Registry < br / > and pull packages | Yes | Yes | Yes |
| Internal project with Package Registry enabled | View Package Registry < br / > and pull packages | No | Yes | Yes |
| Private project with Package Registry enabled | View Package Registry < br / > and pull packages | No | No | Yes |
| Any project with Package Registry disabled | All operations on Package Registry | No | No | No |
2021-12-11 22:18:48 +05:30
## 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 ](../maven_repository/index.md ) | 11.3+ | GA |
| [npm ](../npm_registry/index.md ) | 11.7+ | GA |
| [NuGet ](../nuget_repository/index.md ) | 12.8+ | GA |
| [PyPI ](../pypi_repository/index.md ) | 12.10+ | GA |
| [Generic packages ](../generic_packages/index.md ) | 13.5+ | GA |
| [Composer ](../composer_repository/index.md ) | 13.2+ | [Beta ](https://gitlab.com/groups/gitlab-org/-/epics/6817 ) |
| [Conan ](../conan_repository/index.md ) | 12.6+ | [Beta ](https://gitlab.com/groups/gitlab-org/-/epics/6816 ) |
| [Helm ](../helm_repository/index.md ) | 14.1+ | [Beta ](https://gitlab.com/groups/gitlab-org/-/epics/6366 ) |
| [Debian ](../debian_repository/index.md ) | 14.2+ | [Alpha ](https://gitlab.com/groups/gitlab-org/-/epics/6057 ) |
| [Go ](../go_proxy/index.md ) | 13.1+ | [Alpha ](https://gitlab.com/groups/gitlab-org/-/epics/3043 ) |
| [Ruby gems ](../rubygems_registry/index.md ) | 13.10+ | [Alpha ](https://gitlab.com/groups/gitlab-org/-/epics/3200 ) |
2022-04-04 11:22:00 +05:30
[Status ](../../../policy/alpha-beta-support.md ):
2021-12-11 22:18:48 +05:30
- 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 ](../../../api/packages.md ) to administer the Package Registry.
## Accepting contributions
This table lists unsupported package manager formats that we are accepting contributions for.
2022-07-23 23:45:48 +05:30
Consider contributing to GitLab. This [development documentation ](../../../development/packages/index.md )
2021-12-11 22:18:48 +05:30
guides you through the process.
<!-- vale gitlab.Spelling = NO -->
| Format | Status |
| ------ | ------ |
| Chef | [#36889 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36889 ) |
| CocoaPods | [#36890 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36890 ) |
| Conda | [#36891 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36891 ) |
| CRAN | [#36892 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36892 ) |
| Opkg | [#36894 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36894 ) |
| P2 | [#36895 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36895 ) |
| Puppet | [#36897 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36897 ) |
| RPM | [#5932 ](https://gitlab.com/groups/gitlab-org/-/epics/5128 ) |
| SBT | [#36898 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36898 ) |
| Swift | [#12233 ](https://gitlab.com/gitlab-org/gitlab/-/issues/12233 ) |
| Vagrant | [#36899 ](https://gitlab.com/gitlab-org/gitlab/-/issues/36899 ) |
<!-- vale gitlab.Spelling = YES -->
