date: “2021-07-20T00:00:00+00:00” title: “Package Registry” slug: “packages/overview” draft: false toc: false menu: sidebar:
parent: "packages"
name: "Overview"
weight: 1
identifier: "overview"
Starting with Gitea 1.17, the Package Registry can be used as a public or private registry for common package managers.
Table of Contents
{{< toc >}}
The following package managers are currently supported:
Name | Language | Package client |
---|---|---|
Composer | PHP | composer |
Conan | C++ | conan |
Conda | - | conda |
Container | - | any OCI compliant client |
Generic | - | any HTTP client |
Helm | - | any HTTP client, cm-push |
Maven | Java | mvn , gradle |
npm | JavaScript | npm , yarn , pnpm |
NuGet | .NET | nuget |
Pub | Dart | dart , flutter |
PyPI | Python | pip , twine |
RubyGems | Ruby | gem , Bundler |
Vagrant | - | vagrant |
The following paragraphs only apply if Packages are not globally disabled!
A package always belongs to an owner (a user or organisation), not a repository. To link an (already uploaded) package to a repository, open the settings page on that package and choose a repository to link this package to. The entire package will be linked, not just a single version.
Linking a package results in showing that package in the repository’s package list, and shows a link to the repository on the package site (as well as a link to the repository issues).
Package owner type | User | Organization |
---|---|---|
read access | public, if user is public too; otherwise for this user only | public, if org is public, otherwise for org members only |
write access | owner only | org members with admin or write access to the org |
N.B.: These access restrictions are subject to change, where more finegrained control will be added via a dedicated organization team permission.
Depending on the type of package, use the respective package-manager for that. Check out the sub-page of a specific package manager for instructions.
You can view the packages of a repository on the repository page.
To view more details about a package, select the name of the package.
To download a package from your repository:
You cannot edit a package after you have published it in the Package Registry. Instead, you must delete and recreate it.
To delete a package from your repository:
The Package Registry is automatically enabled. To disable it for a single repository:
Previously published packages are not deleted by disabling the Package Registry.