qports/README.md
2024-08-16 21:45:56 -04:00

2.8 KiB

qports

Upstream: https://ayakael.net/forge/qports

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.

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.

Template builder

The template builder is housed in its own repo 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.

Provided packages

Use abuild-r to build the following packages. For more information on how to build an Alpine Package, read this

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

Omitted packages

  • qubes-vmm-xen - The default Alpine xen package seems to provide the necessary modules

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:

cd /etc/apk/keys
curl -JO https://ayakael.net/api/packages/forge/alpine/key

Add repository to /etc/apk/repositories:

echo "https://ayakael.net/api/packages/forge/alpine/edge/qubes-r4.3" > /etc/apk/repositories

Known issues

Known issues are currently being tracked in qubes-builder-alpine

Issues, recommendations and proposals

To report an issue or share a recommendation

Go here

To make a merge request

  • Fork the repo from Alpine's GitLab here
  • 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