Generic Packages Repository
Publish generic files, like release binaries or other output, for your user or organization.
Table of Contents
Authenticate to the package registry
To authenticate to the Package Registry, you need to provide custom HTTP headers or use HTTP Basic authentication.
Publish a package
To publish a generic package perform a HTTP PUT operation with the package content in the request body. You cannot publish a package if a package of the same name and version already exists. You must delete the existing package first.
PUT https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{file_name}
Parameter | Description |
---|---|
owner |
The owner of the package. |
package_name |
The package name. It can contain only lowercase letters (a-z ), uppercase letter (A-Z ), numbers (0-9 ), dots (. ), hyphens (- ), or underscores (_ ). |
package_version |
The package version as described in the SemVer spec. |
file_name |
The filename. It can contain only lowercase letters (a-z ), uppercase letter (A-Z ), numbers (0-9 ), dots (. ), hyphens (- ), or underscores (_ ). |
Example request using HTTP Basic authentication:
curl --user your_username:your_password_or_token \
--upload-file path/to/file.bin \
https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
The server reponds with the following HTTP Status codes.
HTTP Status Code | Meaning |
---|---|
201 Created |
The package has been published. |
400 Bad Request |
The package name and/or version are invalid or a package with the same name and version already exist. |
Download a package
To download a generic package perform a HTTP GET operation.
GET https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{file_name}
Parameter | Description |
---|---|
owner |
The owner of the package. |
package_name |
The package name. |
package_version |
The package version. |
file_name |
The filename. |
The file content is served in the response body. The response content type is application/octet-stream
.
Example request using HTTP Basic authentication:
curl --user your_username:your_token_or_password \
https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin