2024-08-17 01:41:35 +00:00
|
|
|
# qports
|
|
|
|
|
Upstream: https://ayakael.net/forge/qports
|
2023-08-16 04:42:37 +00:00
|
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
|
|
This repository contains aports that allow Alpine Linux to be used as an Alpine
|
|
|
|
|
Linux template. The upstream repo uses GitLab's CI to build and deploy packages
|
|
|
|
|
targetting multiple Alpine Linux versions. QubesOS releases are tracked using
|
|
|
|
|
branches.
|
|
|
|
|
|
2024-07-11 17:14:44 +00:00
|
|
|
Note for `main` branch: This is currently tracking r4.3 packages, thus are
|
|
|
|
|
experimental. Use this branch at your own risk. For latest r4.2 packages,
|
|
|
|
|
navigate to that branch.
|
|
|
|
|
|
2023-08-27 17:19:12 +00:00
|
|
|
#### Template builder
|
2024-08-17 01:41:35 +00:00
|
|
|
The template builder is housed in its [own repo](https://ayakael.net/forge/qubes-builder-alpine)
|
2023-08-27 17:19:12 +00:00
|
|
|
RPMs are built in-pipeline using the build artifacts produced by this repo. These RPMs facilitate
|
|
|
|
|
installation of your very own Alpine Linux template on QubesOS.
|
|
|
|
|
|
2023-08-16 04:42:37 +00:00
|
|
|
#### Provided packages
|
|
|
|
|
|
|
|
|
|
Use `abuild-r` to build the following packages.
|
|
|
|
|
For more information on how to build an Alpine Package, read [this](https://wiki.alpinelinux.org/wiki/Creating_an_Alpine_package)
|
|
|
|
|
|
|
|
|
|
Core VM packages
|
|
|
|
|
* qubes-vm-xen - Qubes's version of xen
|
|
|
|
|
* qubes-libvchan-xen - libvchan library dependency
|
|
|
|
|
* qubes-db-vm - qubes-db package
|
|
|
|
|
* qubes-vm-utils - qubes-meminfo-writer service package
|
|
|
|
|
* qubes-vm-core - Core init.d / qubes scripts
|
|
|
|
|
* qubes-vm-gui-dev - Library dependencies for `qubes-vm-gui`
|
|
|
|
|
* qubes-vm-gui - GUI agent
|
|
|
|
|
* qubes-vm-qrexec - qrexec agent
|
|
|
|
|
* qubes-gpg-split
|
|
|
|
|
* qubes-usb-proxy
|
|
|
|
|
* qubes-meta-packages - Meta package that pulls everything when added to world
|
|
|
|
|
|
|
|
|
|
Extra packages
|
|
|
|
|
* qubes-pass - Aport for Rudd-O's inter-VM password manager for Qubes OS
|
|
|
|
|
|
2023-08-27 17:19:12 +00:00
|
|
|
Omitted packages
|
|
|
|
|
* qubes-vmm-xen - The default Alpine xen package seems to provide the necessary modules
|
2023-08-16 04:42:37 +00:00
|
|
|
|
2024-08-17 01:41:35 +00:00
|
|
|
## How to use
|
|
|
|
|
|
|
|
|
|
Built packages are made available on a Forgejo-based Alpine repo for you convenience. You can follow these steps to use them:
|
|
|
|
|
|
|
|
|
|
Add security key of the apk repository to your /etc/apk/keys:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
cd /etc/apk/keys
|
|
|
|
|
curl -JO https://ayakael.net/api/packages/forge/alpine/key
|
|
|
|
|
```
|
|
|
|
|
Add repository to `/etc/apk/repositories`:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
echo "https://ayakael.net/api/packages/forge/alpine/edge/qubes-r4.3" > /etc/apk/repositories
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
2023-08-27 17:19:12 +00:00
|
|
|
#### Known issues
|
2024-08-17 01:41:35 +00:00
|
|
|
Known issues are currently being tracked in [qubes-builder-alpine](https://ayakael.net/forge/qubes-builder-alpine/issues)
|
2023-08-16 04:42:37 +00:00
|
|
|
|
|
|
|
|
#### Issues, recommendations and proposals
|
|
|
|
|
**To report an issue or share a recommendation**
|
|
|
|
|
|
|
|
|
|
Go [here](https://gitlab.alpinelinux.org/ayakael/qubes-aports/-/issues)
|
|
|
|
|
|
|
|
|
|
**To make a merge request**
|
|
|
|
|
* Fork the repo from Alpine's GitLab [here](https://gitlab.alpinelinux.org/ayakael/qubes-aports)
|
|
|
|
|
* Clone your fork locally. (`git clone $repo`)
|
|
|
|
|
* Make a branch with a descriptive name (`git checkout -b $descriptivename`)
|
|
|
|
|
* Make the changes you want to see in the world, commit, and push to the GitLab's remote repo
|
|
|
|
|
* Request a merge [here](https://gitlab.alpinelinux.org/ayakael/qubes-aports/-/merge_requests)
|
