SOW Docs
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 with K (or ⌘ with K on macOS) to search this site. Press / outside an input to open command mode directly.
- Get Started — Install SOW, create a flat repository, and build the first Managed workspace.
- Tutorials — Complete YUM, APT, signing, serving, and publication walkthroughs.
- Features — Plain and Managed execution, pool projections, policy, signing, transactions, and audit.
- Design Records — Dated ownership, layout, publication, recovery, and compatibility decisions.
- Commands — Syntax, selection rules, output, state transitions, and exit behavior for every command.
- Reference — Configuration, package references, layouts, JSON, exit codes, platforms, and integration coverage.
Choose a path
| Goal | Start here |
|---|---|
| Index a package directory now | Quick Start |
| Maintain a curated long-lived repository | First Workspace |
| Build a complete YUM or APT repository | Tutorials |
| Look up exact CLI behavior | Commands |
| Check a field, path, or compatibility claim | Reference |
| Understand an architecture decision | Design Records |
Get Started
Install SOW, create a flat repository, and learn the Managed workspace model.
Tutorials
End-to-end walkthroughs that take a pile of packages all the way to a signed repository your clients can install from.
Features
Plain and Managed repository generation, package pools, policy, signing, transactions, publication, and audit.
Reference
Configuration schema, package references, on-disk layout, exit codes, JSON output, platforms, and integrations.
Commands
Complete SOW CLI syntax, options, behavior, output, and exit codes.