Arch package registry

Publish Arch packages for your user or organization. The registry can act as a fully working Arch linux mirror connected directly in /etc/pacman.conf.

Requirements​

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

The following examples use pacman.

Configuring the package registry​

Before you can use the package registry, you need to download the package verification key and add the registry to the pacman config.

Download the package verification key.

wget https://gitea.example.com/api/packages/{owner}/arch/repository.key

Display the id the key (the long line with hex characters).

gpg --show-keys repository.key

Add the key to pacman and sign it (use the key id from the previous step).

pacman-key --add repository.key
pacman-key --lsign-key {key id}

Now add the registry configuration to /etc/pacman.conf.

[{owner}.gitea.example.com]
SigLevel = Required
Server = https://gitea.example.com/api/packages/{owner}/arch/{repository}/{architecture}

Consult the owners package overview to see what repository and architecture is available.

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

Server = https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/arch/{repository}/{architecture}

Publish a package​

To publish an Arch package, perform a HTTP PUT operation with the package content in the request body.

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

Example request using HTTP Basic authentication:

curl --user your_username:your_password_or_token \
     --upload-file path/to/file.pkg.tar.zst \
     https://gitea.example.com/api/packages/testuser/arch/core

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.

Install packages​

To install a package run the pacman sync command:

pacman -Sy {package_name}

Delete a package​

To delete an Arch 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}/arch/{repository}/{package_name}/{package_version}/{architecture}

Example request using HTTP Basic authentication:

curl --user your_username:your_token_or_password -X DELETE \
     https://gitea.example.com/api/packages/testuser/arch/core/test-package/1.0.0/x86-64

The server responds with the following HTTP Status codes.