2022-03-30 14:12:47 +05:30
---
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
2023-02-25 15:26:02 +05:30
identifier: "packages-overview"
2022-03-30 14:12:47 +05:30
---
# Package Registry
2022-05-29 23:40:21 +05:30
Starting with Gitea **1.17** , the Package Registry can be used as a public or private registry for common package managers.
2022-03-30 14:12:47 +05:30
**Table of Contents**
{{< toc > }}
## Supported package managers
The following package managers are currently supported:
| Name | Language | Package client |
| ---- | -------- | -------------- |
2023-02-05 15:42:31 +05:30
| [Cargo ]({{< relref "doc/packages/cargo.en-us.md" >}} ) | Rust | `cargo` |
2023-02-06 07:19:21 +05:30
| [Chef ]({{< relref "doc/packages/chef.en-us.md" >}} ) | - | `knife` |
2022-03-30 14:12:47 +05:30
| [Composer ]({{< relref "doc/packages/composer.en-us.md" >}} ) | PHP | `composer` |
| [Conan ]({{< relref "doc/packages/conan.en-us.md" >}} ) | C++ | `conan` |
2023-02-02 00:00:39 +05:30
| [Conda ]({{< relref "doc/packages/conda.en-us.md" >}} ) | - | `conda` |
2022-03-30 14:12:47 +05:30
| [Container ]({{< relref "doc/packages/container.en-us.md" >}} ) | - | any OCI compliant client |
| [Generic ]({{< relref "doc/packages/generic.en-us.md" >}} ) | - | any HTTP client |
2022-04-19 22:25:35 +05:30
| [Helm ]({{< relref "doc/packages/helm.en-us.md" >}} ) | - | any HTTP client, `cm-push` |
2022-03-30 14:12:47 +05:30
| [Maven ]({{< relref "doc/packages/maven.en-us.md" >}} ) | Java | `mvn` , `gradle` |
2022-12-02 21:53:47 +05:30
| [npm ]({{< relref "doc/packages/npm.en-us.md" >}} ) | JavaScript | `npm` , `yarn` , `pnpm` |
2022-03-30 14:12:47 +05:30
| [NuGet ]({{< relref "doc/packages/nuget.en-us.md" >}} ) | .NET | `nuget` |
2022-08-07 15:39:54 +05:30
| [Pub ]({{< relref "doc/packages/pub.en-us.md" >}} ) | Dart | `dart` , `flutter` |
2022-03-30 14:12:47 +05:30
| [PyPI ]({{< relref "doc/packages/pypi.en-us.md" >}} ) | Python | `pip` , `twine` |
| [RubyGems ]({{< relref "doc/packages/rubygems.en-us.md" >}} ) | Ruby | `gem` , `Bundler` |
2022-08-29 12:34:45 +05:30
| [Vagrant ]({{< relref "doc/packages/vagrant.en-us.md" >}} ) | - | `vagrant` |
2022-03-30 14:12:47 +05:30
**The following paragraphs only apply if Packages are not globally disabled!**
2022-04-01 21:01:40 +05:30
## Repository-Packages
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).
## Access Restrictions
| Package owner type | User | Organization |
|--------------------|------|--------------|
2023-01-17 03:54:24 +05:30
| **read** access | public, if user is public too; otherwise for this user only | public, if org is public, otherwise for org members only |
2022-04-01 21:01:40 +05:30
| **write** access | owner only | org members with admin or write access to the org |
N.B.: These access restrictions are [subject to change ](https://github.com/go-gitea/gitea/issues/19270 ), where more finegrained control will be added via a dedicated organization team permission.
## Create or upload a package
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.
2022-03-30 14:12:47 +05:30
## View packages
You can view the packages of a repository on the repository page.
1. Go to the repository.
1. Go to **Packages** in the navigation bar.
To view more details about a package, select the name of the package.
## Download a package
To download a package from your repository:
1. Go to **Packages** in the navigation bar.
1. Select the name of the package to view the details.
1. In the **Assets** section, select the name of the package file you want to download.
## Delete a package
2023-01-17 03:54:24 +05:30
You cannot edit a package after you have published it in the Package Registry. Instead, you
2022-03-30 14:12:47 +05:30
must delete and recreate it.
To delete a package from your repository:
1. Go to **Packages** in the navigation bar.
1. Select the name of the package to view the details.
1. Click **Delete package** to permanently delete the package.
## Disable the Package Registry
The Package Registry is automatically enabled. To disable it for a single repository:
1. Go to **Settings** in the navigation bar.
1. Disable **Enable Repository Packages Registry** .
Previously published packages are not deleted by disabling the Package Registry.