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.