Alpine Package Registry

Publish Alpine packages for your user or organization.

Requirements​

To work with the Alpine registry, you need to use a HTTP client like curl to upload and a package manager like apk to consume packages.

The following examples use apk.

Configuring the package registry​

To register the Alpine registry add the url to the list of known apk sources (/etc/apk/repositories):

https://gitea.example.com/api/packages/{owner}/alpine/<branch>/<repository>

If the registry is private, provide credentials in the url. You can use a password or a personal access token:

https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/alpine/<branch>/<repository>

The Alpine registry files are signed with a RSA key which must be known to apk. Download the public key and store it in /etc/apk/keys/:

curl -JO https://gitea.example.com/api/packages/{owner}/alpine/key

Afterwards update the local package index:

apk update

Publish a package​

To publish an Alpine package (*.apk), perform a HTTP PUT operation with the package content in the request body.

PUT https://gitea.example.com/api/packages/{owner}/alpine/{branch}/{repository}

Example request using HTTP Basic authentication:

curl --user your_username:your_password_or_token \
     --upload-file path/to/file.apk \
     https://gitea.example.com/api/packages/testuser/alpine/v3.17/main

If you are using 2FA or OAuth use a personal access token instead of the password. You cannot publish a file with the same name twice to a package. You must delete the existing package file first.

The server responds with the following HTTP Status codes.

Delete a package​

To delete an Alpine package perform a HTTP DELETE operation. This will delete the package version too if there is no file left.

DELETE https://gitea.example.com/api/packages/{owner}/alpine/{branch}/{repository}/{architecture}/{filename}

Example request using HTTP Basic authentication:

curl --user your_username:your_token_or_password -X DELETE \
     https://gitea.example.com/api/packages/testuser/alpine/v3.17/main/test-package-1.0.0.apk

The server responds with the following HTTP Status codes.

Install a package​

To install a package from the Alpine registry, execute the following commands:

# use latest version
apk add {package_name}
# use specific version
apk add {package_name}={package_version}