# Den Documentation Den is a bootable Linux distribution experiment where conda owns the system package graph. Buildroot supplies a small early boot layer, then the machine switches into a conda-owned root filesystem with systemd, package generations, and rollback. The current proven artifact path is intentionally narrow: a hosted conda channel, native Linux arm64 and amd64 image workflows, QEMU boot bundles, local OCI inspection images, and UEFI raw/qcow2 disks for QEMU. Candidate and promotion workflows now implement signed OCI images and verifiable release directories, but those remain unproven until the first public release passes. Den asks whether conda can grow from a developer-environment tool into a locked package graph for a whole operating system. ## Documentation Layout These docs follow the Diataxis model: - Tutorials teach by walking you through a contained learning path. - How-to guides give task-focused commands for people already oriented. - Reference records facts about commands, files, packages, and artifacts. - Explanation gives the design context and tradeoffs. This mirrors the shape of the conda-workspaces documentation: a fast entry point, task-oriented pages, exact command/reference material, and explanation for motivation and design. ```{toctree} :hidden: :caption: Tutorials tutorials/boot-den-in-qemu tutorials/build-python-web-container tutorials/run-scipy-container tutorials/explore-system-generations tutorials/inspect-den-with-the-system-manager ``` ```{toctree} :hidden: :caption: How-To how-to/adapt-a-workload-image how-to/build-the-root-filesystem how-to/run-smoke-tests how-to/build-a-qemu-bundle how-to/build-oci-and-uefi-images how-to/use-an-existing-image how-to/run-with-orbstack-and-virtualbox how-to/check-den-status-and-plan-updates how-to/add-a-den-package how-to/publish-den-packages ``` ```{toctree} :hidden: :caption: Reference reference/architecture reference/commands reference/den-command reference/targets reference/filesystem-layout reference/generation-receipts reference/packages reference/artifacts reference/agent-sandbox-prototype reference/use-case-matrix ``` ```{toctree} :hidden: :caption: Explanation explanation/why-a-conda-owned-os explanation/where-den-fits explanation/sandboxed-agent-runtimes explanation/layering-and-abi-boundary explanation/generations-and-rollback explanation/den-system-manager explanation/what-a-real-distribution-needs explanation/compliance-and-redistribution ``` ## Tutorials - [Boot Den In QEMU](tutorials/boot-den-in-qemu.md) - [Build A Python Web Container From Den](tutorials/build-python-web-container.md) - [Run A SciPy Container From Den](tutorials/run-scipy-container.md) - [Explore System Generations](tutorials/explore-system-generations.md) - [Inspect Den With The System Manager](tutorials/inspect-den-with-the-system-manager.md) ## How-To Guides - [Adapt A Workload Image](how-to/adapt-a-workload-image.md) - [Build The Root Filesystem](how-to/build-the-root-filesystem.md) - [Run Smoke Tests](how-to/run-smoke-tests.md) - [Build A QEMU Bundle](how-to/build-a-qemu-bundle.md) - [Build OCI And UEFI Images](how-to/build-oci-and-uefi-images.md) - [Use An Existing Image](how-to/use-an-existing-image.md) - [Run With OrbStack And VirtualBox](how-to/run-with-orbstack-and-virtualbox.md) - [Check Den Status And Plan Updates](how-to/check-den-status-and-plan-updates.md) - [Add A Den Package](how-to/add-a-den-package.md) - [Publish Den Packages](how-to/publish-den-packages.md) ## Reference - [Architecture Reference](reference/architecture.md) - [Command Reference](reference/commands.md) - [Den Command Reference](reference/den-command.md) - [Target Reference](reference/targets.md) - [Filesystem Layout](reference/filesystem-layout.md) - [Generation Receipt Reference](reference/generation-receipts.md) - [Package Reference](reference/packages.md) - [Artifact Reference](reference/artifacts.md) - [Agent Sandbox Prototype Reference](reference/agent-sandbox-prototype.md) - [Use-Case Matrix](reference/use-case-matrix.md) ## Explanation - [Why A Conda-Owned OS](explanation/why-a-conda-owned-os.md) - [Where Den Fits](explanation/where-den-fits.md) - [Sandboxed Agent Runtimes](explanation/sandboxed-agent-runtimes.md) - [Layering And ABI Boundary](explanation/layering-and-abi-boundary.md) - [Generations And Rollback](explanation/generations-and-rollback.md) - [Den System Manager](explanation/den-system-manager.md) - [What A Real Distribution Needs](explanation/what-a-real-distribution-needs.md) - [Compliance And Redistribution](explanation/compliance-and-redistribution.md) ## Current Status The prototype can: - consume Den-owned conda packages built and published by `den-os/den-forge`, - stage a runtime prefix under `/opt/den`, - stage a system generation under `/den/generations/1/sw`, - apply boot-critical rootfs layout manifests from package metadata, - build a Buildroot kernel and initramfs early boot layer, - boot in QEMU through Den stage1, - boot packaged systemd as PID 1, - record, validate, activate, and roll back system generations, - inspect Den status and generation health with `den`, - print a non-mutating update plan with `den update --dry-run`, - install and activate a new generation from an existing workspace archive with `den update --archive`, - consume the hosted Den package channel at `packages.den-os.org`, - authenticate pushes to the zot registry at `registry.den-os.org`, - build and smoke-test the staged rootfs from that hosted release channel, - package the QEMU AArch64 prototype as `den-qemu-aarch64.tar.zst`, - model a QEMU x86_64 target for linux-64 package and image work, - build and smoke-test a local Docker/OCI image named `den:dev`, - expose `den sandbox` execution paths for QEMU, Docker, Podman, and Apple `container`, with signed Den release image verification before execution, - build and smoke-test a GRUB-backed UEFI raw/qcow2 disk for QEMU. The prototype still cannot: - publish a signed, mirrored, multi-region package channel, - boot through systemd-boot, - install itself onto a disk, - act as a provider-ready cloud image across real provider metadata services, - sign boot artifacts or package locks, - prove signed OCI release images and SBOM attachments end to end, - prove complete SBOM, license, source, and provenance evidence through a promoted public release, - solve, lock, and build a workspace archive directly from a running machine.