# SOW Docs

> Create and manage RPM/YUM and DEB/APT repositories with one self-contained binary.

---

LLMS index: [llms.txt](/llms.txt)

---

SOW is Pigsty's self-contained package repository manager. `sow create` turns the RPM and
DEB files in a directory into a usable flat repository. Managed workspaces add package
membership, policy, signing, immutable generations, audit history, and publication targets.

Press Ctrl + K (or ⌘ + K on macOS) to search this
site. Press \/ outside an input to open command mode directly.

- [Get Started](/docs/start/) — Install SOW, create a flat repository, and build the first Managed workspace.
- [Tutorials](/docs/tutorial/) — Complete YUM, APT, signing, serving, and publication walkthroughs.
- [Features](/docs/feature/) — Plain and Managed execution, pool projections, policy, signing, transactions, and audit.
- [Design Records](/blog/design/) — Dated ownership, layout, publication, recovery, and compatibility decisions.
- [Commands](/docs/command/) — Syntax, selection rules, output, state transitions, and exit behavior for every command.
- [Reference](/docs/reference/) — Configuration, package references, layouts, JSON, exit codes, platforms, and integration coverage.
{.cards}

## Choose a path

| Goal | Start here |
|---|---|
| Index a package directory now | [Quick Start](/docs/start/quickstart/) |
| Maintain a curated long-lived repository | [First Workspace](/docs/start/workspace/) |
| Build a complete YUM or APT repository | [Tutorials](/docs/tutorial/) |
| Look up exact CLI behavior | [Commands](/docs/command/) |
| Check a field, path, or compatibility claim | [Reference](/docs/reference/) |
| Understand an architecture decision | [Design Records](/blog/design/) |

---

Section pages:

- [Get Started](/docs/start/): Install SOW, create a flat repository, and learn the Managed workspace model.
- [Tutorials](/docs/tutorial/): End-to-end walkthroughs that take a pile of packages all the way to a signed repository your clients can install from.
- [Features](/docs/feature/): Plain and Managed repository generation, package pools, policy, signing, transactions, publication, and audit.
- [Reference](/docs/reference/): Configuration schema, package references, on-disk layout, exit codes, JSON output, platforms, and integrations.
- [Commands](/docs/command/): Complete SOW CLI syntax, options, behavior, output, and exit codes.