# Dory

> Dory is a native, open-source macOS runtime for Docker, Compose, Kubernetes, full Linux desktops, persistent servers, local networking, migration, diagnostics, and coding-agent automation.

Dory 0.3.2 supports Apple Silicon on macOS 14 or later and bundles its own Docker engine and command-line tools. Its optional Linux-machine profiles are managed Debian 13, Ubuntu 24.04 LTS, and Kali rolling Xfce desktops with configurable users plus lightweight Alpine headless VMs. Intel hosts and desktop distributions beyond those three are not part of the current release.

Dory ships one Docker Core app. A signed catalog adds removable Kubernetes, Linux Machines, Linux Desktop Runtime, Debian, Ubuntu, and Kali components to the selected Dory data drive. The website verifies the catalog and shows the exact total before download. Removing a component reclaims its payload without deleting workload data.

## Canonical documentation

- [Complete agent reference](https://augani.github.io/dory/llms-full.txt): Stable commands, safety rules, schemas, recovery, examples, and product boundaries
- [Versioned agent capability map](https://augani.github.io/dory/agent-guide.json): Machine-readable JSON contract for Dory 0.3.2
- [Agent and MCP guide](https://augani.github.io/dory/docs/agents.md): MCP configuration, tools, machine execution, sandbox policy, and recovery loop
- [Operations guide](https://augani.github.io/dory/docs/operations.md): Installation, storage, networking, migration, diagnostics, and repair
- [Compatibility contract](https://augani.github.io/dory/docs/compatibility.md): Supported, preview, and unavailable behavior
- [Production architecture](https://augani.github.io/dory/docs/architecture.md): Process ownership, Docker path, storage, updates, trust boundaries, and capability status
- [Performance evidence](https://augani.github.io/dory/docs/performance.md): Exact-candidate methodology, raw performance and reliability assets, statistics, and unqualified-claim policy
- [Human website](https://augani.github.io/dory/): Product overview and installation
- [Source repository](https://github.com/Augani/dory): Source, README, releases, changelog, and issues
- [Latest release](https://github.com/Augani/dory/releases/latest): Signed and notarized Apple Silicon build

## Agent entry points

- Inspect the live local contract: `dory agent guide --json`
- Start the stdio MCP server: `dory mcp serve --read-only`
- Inspect health before changing state: `dory doctor --json`
- Collect a redacted evidence bundle: `dory support bundle --json --active`
- Wait for state without custom polling: `dory wait engine --until running --timeout 60 --json`
- Stream runtime events: `dory events --follow --json`
- Inspect verified local machine backup schedules: `dory machine backup status`

Prefer JSON and read-only commands. Run dry runs before writes. Never add `--apply`, `--include-volumes`, a delete verb, or an engine restart unless the user or task has authorized that change.
Dory's MCP is a local Dory control surface, not a third-party tool catalog. Scheduled machine
backups are verified local recovery bundles, not a managed offsite/S3 service.