Skip to content
OpenCharly

cachyos-pacstrap

Recipe card from the charly-distros plugin (Images — the deployable catalog).

cachyos-pacstrap

Section titled “cachyos-pacstrap”

Bootstrap-from-scratch CachyOS root filesystem, built via pacstrap inside the privileged /charly-distros:cachyos-pacstrap-builder container (from: builder:pacstrap, bootstrap_builder_image: cachyos-pacstrap-builder).

Lives in opencharly/distro-cachyos (git submodule at box/cachyos). Build: charly -C box/cachyos box build cachyos-pacstrap.

When to use it (and when not)

Section titled “When to use it (and when not)”

The canonical CachyOS base (/charly-distros:cachyos) pulls the upstream-published OCI image from Docker Hub — that is the recommended path and the one the CachyOS project itself uses. This pacstrap variant exists for offline / air-gapped builds and as a worked example of the from: builder:pacstrap + bootstrap_builder_image: pattern.

pacstrap x86_64_v3 + SigLevel (fixed)

Section titled “pacstrap x86_64_v3 + SigLevel (fixed)”

Without the shared renderPacstrapExtraConf helper the privileged pacstrap step rejects the CachyOS x86_64_v3 packages (package architecture is not valid) and, on the VM path, trips GPGME signature checks (GPGME error: No data) — both symptoms are worth recognising. It handles them (candy/plugin-vm/vm_bootstrap_engine.go:57, used by both runPrivilegedBootstrap and the VM bootstrap engine — the former charly/build.go/charly/vm_bootstrap.go are DELETED, K-wave 2):

  1. it derives an [options] Architecture = x86_64 x86_64_v3 directive from the cachyos-v3 repos’ microarch token, so pacman accepts linux-cachyos etc.;
  2. it emits each repo’s SigLevel — the VM bootstrap path previously open-coded the loop and dropped SigLevel, so SigLevel = Never cachyos repos fell back to signature-required and GPGME failed. Both paths now share one renderer (R3), so they can’t diverge again.

Verified live: charly -C box/cachyos box build cachyos-pacstrap produces a rootfs with linux-cachyos (%ARCH% = x86_64_v3) installed. (Requires an charly with this fix — newer than the published release.) The Docker-Hub /charly-distros:cachyos base is still the faster default (no privileged build).

Box Properties

Section titled “Box Properties”
Property Value
From builder:pacstrap
bootstrap_builder_image cachyos-pacstrap-builder
Distro cachyos, arch
Build pac
Home repo opencharly/distro-cachyos (box/cachyos)

The cachyos distro config (pacstrap base packages, CachyOS keyring F3B607488DB35A47, mirrorlist, cachyos* repos) lives in the embedded build vocabulary (charly/charly.yml, baked into the charly binary) and is resolved by name whenever a box declares distro: cachyos.

Cross-References

Section titled “Cross-References”

When to Use This Skill

Section titled “When to Use This Skill”

MUST be invoked before building or debugging the CachyOS pacstrap rootfs. Invoke BEFORE reading source code or launching Explore agents.