Check Den Status And Plan Updates¶
Use den when you need to inspect a Den rootfs or image without changing it.
Check A Running Den System¶
Inside a Den system:
den status
den doctor
den generations current
den generations list
den update --dry-run
den channels list
den seed status
den ssh keys
den boot status
den doctor exits with status code 1 if it finds a critical failure.
Warnings are printed but do not make the command fail.
Check A Staged Rootfs¶
From the repository root:
build/rootfs/den/generations/1/sw/usr/lib/den/den --root build/rootfs status
build/rootfs/den/generations/1/sw/usr/lib/den/den --root build/rootfs doctor
build/rootfs/den/generations/1/sw/usr/lib/den/den --root build/rootfs update --dry-run
The --root option points den at a mounted or staged filesystem tree.
Absolute paths in the output still describe the paths as they would appear
inside the Den machine.
Install From A Workspace Archive¶
den update expects an existing conda workspace archive. In the repository
workflow, ct run workspace-archive creates build/den-workspace.tar.zst.
Inside a running Den system:
den update --archive /var/cache/den/den-workspace.tar.zst
The update command uses /var/cache/den/pkgs as conda’s package cache. It
replaces an inherited /opt/den/pkgs setting, while preserving an explicitly
different CONDA_PKGS_DIRS. Keep that cache on a Linux filesystem when testing
from macOS bind mounts so conda package verification sees the same file layout
it will see in a real image.
The archive install runs through the public conda-workspaces WorkspaceArchive
API in the Den runtime environment.
For a mounted or staged rootfs, run the command inside a compatible target environment or container. The local smoke target does this for the Linux/AArch64 rootfs:
ct run generation-smoke
Use --no-activate to install and validate the next generation without
switching /den/current-system.
Check The OCI Inspection Image¶
Build and smoke-test the local OCI image:
ct run oci-smoke
The smoke target checks:
den status,den doctor,den generations current,den update --dry-run,den channels list,den seed status,den ssh keys,den boot status,den prune --keep 1,conda den --help,the conda runtime configuration.
Use The Conda Plugin Form¶
The runtime prefix also installs den as a conda plugin:
conda den --help
Use the top-level den command inside a running or mounted Den image. Use
conda den when you are already working through conda and want the same command
surface.