code.gitea.io/gitea@v1.22.3/docs/content/usage/packages/overview.en-us.md (about)

     1  ---
     2  date: "2021-07-20T00:00:00+00:00"
     3  title: "Package Registry"
     4  slug: "overview"
     5  sidebar_position: 1
     6  draft: false
     7  toc: false
     8  menu:
     9    sidebar:
    10      parent: "packages"
    11      name: "Overview"
    12      sidebar_position: 1
    13      identifier: "packages-overview"
    14  ---
    15  
    16  # Package Registry
    17  
    18  Starting with Gitea **1.17**, the Package Registry can be used as a public or private registry for common package managers.
    19  
    20  ## Supported package managers
    21  
    22  The following package managers are currently supported:
    23  
    24  | Name | Language | Package client |
    25  | ---- | -------- | -------------- |
    26  | [Alpine](usage/packages/alpine.md) | - | `apk` |
    27  | [Cargo](usage/packages/cargo.md) | Rust | `cargo` |
    28  | [Chef](usage/packages/chef.md) | - | `knife` |
    29  | [Composer](usage/packages/composer.md) | PHP | `composer` |
    30  | [Conan](usage/packages/conan.md) | C++ | `conan` |
    31  | [Conda](usage/packages/conda.md) | - | `conda` |
    32  | [Container](usage/packages/container.md) | - | any OCI compliant client |
    33  | [CRAN](usage/packages/cran.md) | R | - |
    34  | [Debian](usage/packages/debian.md) | - | `apt` |
    35  | [Generic](usage/packages/generic.md) | - | any HTTP client |
    36  | [Go](usage/packages/go.md) | Go | `go` |
    37  | [Helm](usage/packages/helm.md) | - | any HTTP client, `cm-push` |
    38  | [Maven](usage/packages/maven.md) | Java | `mvn`, `gradle` |
    39  | [npm](usage/packages/npm.md) | JavaScript | `npm`, `yarn`, `pnpm` |
    40  | [NuGet](usage/packages/nuget.md) | .NET | `nuget` |
    41  | [Pub](usage/packages/pub.md) | Dart | `dart`, `flutter` |
    42  | [PyPI](usage/packages/pypi.md) | Python | `pip`, `twine` |
    43  | [RPM](usage/packages/rpm.md) | - | `yum`, `dnf`, `zypper` |
    44  | [RubyGems](usage/packages/rubygems.md) | Ruby | `gem`, `Bundler` |
    45  | [Swift](usage/packages/swift.md) | Swift | `swift` |
    46  | [Vagrant](usage/packages/vagrant.md) | - | `vagrant` |
    47  
    48  **The following paragraphs only apply if Packages are not globally disabled!**
    49  
    50  ## Repository-Packages
    51  
    52  A package always belongs to an owner (a user or organisation), not a repository.
    53  To link an (already uploaded) package to a repository, open the settings page
    54  on that package and choose a repository to link this package to.
    55  The entire package will be linked, not just a single version.
    56  
    57  Linking a package results in showing that package in the repository's package list,
    58  and shows a link to the repository on the package site (as well as a link to the repository issues).
    59  
    60  ## Access Restrictions
    61  
    62  | Package owner type | User | Organization |
    63  |--------------------|------|--------------|
    64  | **read** access    | public, if user is public too; otherwise for this user only | public, if org is public, otherwise for org members only |
    65  | **write** access   | owner only | org members with admin or write access to the org |
    66  
    67  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.
    68  
    69  ## Create or upload a package
    70  
    71  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.
    72  
    73  ## View packages
    74  
    75  You can view the packages of a repository on the repository page.
    76  
    77  1. Go to the repository.
    78  1. Go to **Packages** in the navigation bar.
    79  
    80  To view more details about a package, select the name of the package.
    81  
    82  ## Download a package
    83  
    84  To download a package from your repository:
    85  
    86  1. Go to **Packages** in the navigation bar.
    87  1. Select the name of the package to view the details.
    88  1. In the **Assets** section, select the name of the package file you want to download.
    89  
    90  ## Delete a package
    91  
    92  You cannot edit a package after you have published it in the Package Registry. Instead, you
    93  must delete and recreate it.
    94  
    95  To delete a package from your repository:
    96  
    97  1. Go to **Packages** in the navigation bar.
    98  1. Select the name of the package to view the details.
    99  1. Click **Delete package** to permanently delete the package.
   100  
   101  ## Disable the Package Registry
   102  
   103  The Package Registry is automatically enabled. To disable it for a single repository:
   104  
   105  1. Go to **Settings** in the navigation bar.
   106  1. Disable **Enable Repository Packages Registry**.
   107  
   108  Previously published packages are not deleted by disabling the Package Registry.