SOW Docs
Create and manage RPM/YUM and DEB/APT repositories with one self-contained binary.
SOW creates RPM/YUM and DEB/APT software repositories. Run sow create DIR to index
packages in a directory. Use a Managed workspace when you need to organize packages into
Dists, limit versions, sign metadata, or publish updates.
These docs cover SOW 0.6.0. See the release notes for version changes and the upgrade guide for an existing Managed workspace.
- Get Started — Install SOW, create a flat repository, and build the first Managed workspace.
- Tutorials — Complete YUM, APT, signing, serving, and publication walkthroughs.
- Features — How package storage, filtering, signing, and recovery work.
- Design Records — The reasons behind the architecture and its history.
- Commands — Options, examples, output, and exit codes for every command.
- Reference — Configuration fields, package names, directory layouts, and compatibility.
Choose a path
| Goal | Start here |
|---|---|
| Index a package directory now | Quick Start |
| Replace an existing createrepo_c workflow | Migrate an Existing YUM Repository |
| Maintain a curated long-lived repository | First Workspace |
| Build a complete YUM or APT repository | Tutorials |
| Look up exact CLI behavior | Commands |
| Resolve an error or interrupted command | Troubleshooting |
| 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
Build, sign, serve, and update RPM and DEB repositories.
Features
Choose a repository mode, then add package policies, signing, publication, and audit.
Reference
Look up configuration, package references, file paths, command results, and troubleshooting steps.
Commands
SOW command syntax, options, selection rules, and exit codes.
