Command Reference¶
Run these commands from the repository root.
Run ct run dev-install-den first when you want to use direct den ...
commands from the development environment.
Rootfs And Workspace¶
Command |
Description |
|---|---|
|
Lock the conda workspace using the configured Den package channel. |
|
Install the target image workspace |
|
Install the target image workspace |
|
Create |
|
Stage the Den rootfs under |
|
Build and validate the staged rootfs userland. |
Den System Manager¶
Command |
Description |
|---|---|
|
Show release, generation, channel, boot metadata, and validation status. |
|
Check active generation, rootfs layout, metadata, state dirs, and image state. |
|
Print the active generation number. |
|
List installed generations and mark the active one. |
|
Validate a generation’s prefix, init, and receipt files. |
|
Compare package inventories for two generations. |
|
Print the next generation transaction plan without changing the system. |
|
Install, record, validate, and activate the next generation from a workspace archive. |
|
Validate and activate an installed generation. |
|
Roll back to an older or specific generation. |
|
Plan inactive generation cleanup; add |
|
List channels from |
|
Replace channels in |
|
Print the active Den package release train from forge metadata. |
|
Inspect NoCloud seed state. |
|
List SSH host keys. |
|
Inspect stage1, systemd, and boot artifact metadata. |
|
Validate the staged rootfs in-toto receipt and tree digest. |
|
Validate the ext4 rootfs image receipt and image hash. |
|
Validate the QEMU bundle receipt, artifact hashes, and receipt inputs. |
|
Validate the UEFI raw/qcow2 disk receipt and disk hashes. |
|
Validate a complete Den release directory and release receipt. |
|
Assemble release files and write the aggregate release receipt. |
|
Download files declared by an already authenticated release receipt. |
|
Run a command in a Den sandbox backend and write an execution receipt. |
|
Validate a sandbox execution receipt and output tree digest. |
|
Print sandbox defaults and supported backends. |
|
Remove sandbox output and work directories. |
|
Access the same command surface through conda’s plugin system. |
Recipes¶
Command |
Description |
|---|---|
|
From |
|
From |
|
From |
|
From |
|
From |
|
From |
|
From |
|
From |
|
From |
Buildroot¶
Command |
Description |
|---|---|
|
Download Buildroot if needed, apply the Den defconfig, and build the kernel/initramfs. |
|
Delete the cached Buildroot output when intentional. |
Images And Boot¶
Command |
Description |
|---|---|
|
Create |
|
Boot QEMU through stage1 and run a bash smoke. |
|
Boot QEMU through packaged systemd and run the systemd smoke. |
|
Create, activate, validate, and roll back a second generation. |
|
Create the target QEMU bundle under |
|
Verify the extracted QEMU bundle and boot it. |
|
Build the local |
|
Build |
|
Build the target UEFI raw and qcow2 disk images. |
|
Boot a seeded UEFI smoke copy with target-specific UEFI firmware in QEMU. |
|
Convert the target UEFI raw disk to a VDI image. |
|
Inspect image-building commands. |
|
Inspect smoke-test commands. |
|
Validate a staged rootfs directly. |
|
Validate a staged rootfs through native Linux chroot. |
|
Validate update and rollback behavior directly. |
|
Verify and boot a bundle on a native runner. |
|
Build and boot the UEFI smoke disk on a native runner. |
Safety¶
Normal targets should not:
install host packages,
modify host boot settings,
require privileged host mounts,
require private package-channel credentials.