Artifact Reference¶
Workspace Archive¶
build/den-workspace.tar.zst
Created by:
ct run workspace-archive
Used by rootfs staging and generation smoke tests.
Staged Rootfs¶
build/rootfs
Created by:
ct run rootfs
This is a directory tree, not a disk image.
Receipt:
build/rootfs/etc/den/rootfs.receipt.json
Rootfs Disk Image¶
build/artifacts/den-rootfs.ext4
Created by:
ct run rootfs-image
The image size is currently 4 GiB.
Receipt:
build/artifacts/den-rootfs.ext4.receipt.json
Buildroot Boot Artifacts¶
build/buildroot/images/Image
build/buildroot/images/rootfs.cpio.gz
build/buildroot/target/bin/busybox
Created by:
den image early-boot
Heavy Buildroot output is cached in:
build/buildroot-output
QEMU Bundle¶
build/artifacts/den-qemu-aarch64.tar.zst
Created by:
ct run image-bundle
Contents:
Image
rootfs.cpio.gz
den-rootfs.ext4
boot-qemu.sh
manifest.toml
SHA256SUMS
receipt.json
den-rootfs.ext4.receipt.json
manifest.toml records:
target,
architecture,
creation time,
source commit,
dirty-source flag,
Buildroot version,
Buildroot defconfig,
current generation,
lockfile hash,
workspace manifest hash,
package count,
per-artifact hashes and sizes.
receipt.json records the bundle as an in-toto Statement and binds the copied
rootfs image receipt when present.
Artifact Receipts¶
Rootfs, rootfs image, QEMU bundle, and UEFI disk artifacts write JSON receipts using:
_type = https://in-toto.io/Statement/v1,predicateType = https://den-os.org/schemas/den-artifact-receipt-1.schema.json,subject[]entries with SHA-256 digests for produced artifacts,a Den predicate with the artifact kind, target, inputs, and metadata.
Den validates these receipts with vendored JSON schemas and the Python
jsonschema library. Validation is offline and does not fetch schemas from the
network. After schema validation, den verify recomputes subject hashes,
checks receipt input hashes when local input paths are recorded, verifies the
staged rootfs tree digest, and rejects unsafe paths or symlink escapes.
Individual artifact receipts are integrity and provenance documents, not signatures. The release workflow binds them into an aggregate release receipt and signs that receipt separately with keyless Cosign.
Release Directory¶
Candidate releases use:
https://releases.den-os.org/candidates/2026.6-rc.1/
Promoted releases use:
https://releases.den-os.org/2026.6/
Each release contains qemu-aarch64/ and qemu-x86_64/ directories plus
SHA256SUMS, release.receipt.json, its Sigstore bundle, and a static index.
The release receipt is published last as the completeness marker. Candidate
and final locations become supported interfaces only after their workflows
have passed against the public URLs.
Docker/OCI Inspection Image¶
den:dev
Created by:
ct run oci-image
Verified by:
ct run oci-smoke
This is a FROM scratch Linux arm64 image containing the staged Den rootfs.
It is useful for inspecting files and running simple userland checks through
Docker/OrbStack. It is not a bootable VM image and does not run systemd as PID
1 in Docker.
It can also be used as a local base image for application containers with:
FROM den:dev
Application containers should usually create their own app environment, for
example under /opt/app, instead of installing workload dependencies into
/opt/den.
The OCI image is built directly from build/rootfs. It does not require the
Buildroot kernel or initramfs.
The generated image sets:
PATH=/opt/den/bin:/run/current-system/sw/bin:/bin:/usr/bin:/sbin:/usr/sbin
The rootfs includes /etc/conda/.condarc with:
channels:
- conda-forge
channel_priority: strict
default_channels: []
Package And License Reports¶
build/artifacts/reports/conda-packages.json
build/artifacts/reports/conda-licenses.md
Created by:
den report packages --rootfs build/rootfs --output-dir build/artifacts/reports
ct run package-report
The reports are generated from the active staged generation’s conda prefix metadata. They record installed conda packages, versions, builds, channels, artifact hashes, dependency metadata, and license expressions where conda metadata provides them.
UEFI Disk Image¶
build/artifacts/den-uefi-aarch64.raw
build/artifacts/den-uefi-aarch64.qcow2
build/artifacts/den-uefi-aarch64.receipt.json
Created by:
ct run uefi-image
Verified by:
ct run uefi-image-smoke
The raw disk is a GPT image with:
partition 1: FAT EFI system partition labeled
DEN_ESP,partition 2: ext4 Den rootfs labeled by the partition name
DEN_ROOT.
The EFI system partition contains:
EFI/BOOT/BOOTAA64.EFI
den/Image
den/rootfs.cpio.gz
BOOTAA64.EFI is a GRUB standalone EFI binary with an embedded config that
searches for DEN_ESP, loads the Buildroot kernel and initramfs, and passes
the root partition as /dev/vda2.
The .qcow2 file is converted from the raw disk with qemu-img. The current
artifact is only a first QEMU UEFI disk
prototype. It includes Den’s NoCloud-style seed handler and first-boot rootfs
growth, but it does not query provider metadata services or include
provider-specific image metadata.
VirtualBox VDI¶
build/artifacts/den-virtualbox-aarch64.vdi
Created by:
ct run virtualbox-image
This is converted from build/artifacts/den-uefi-aarch64.raw with
qemu-img -O vdi. It is not boot-smoked and is not part of the supported
runtime matrix yet.