Skip to content

Get Started

Install SOW, create a flat repository, and learn the Managed workspace model.

SOW builds static RPM/YUM and DEB/APT repositories; it is not an HTTP daemon. Choose one of two isolated paths:

  • Plain: sow create rebuilds indexes beside the packages in an ordinary directory.

  • Managed: a workspace tracks package membership, Dists, architecture views, policy, signing, generations, audit history, and publication targets.

  • Installation — Choose a release archive, RPM/DEB package, or source build; verify the installed binary.

  • Quick Start — Create and serve a flat repository from a directory of packages.

  • First Workspace — Initialize Managed mode, create RPM and DEB Dists, add packages, build, and check.

  • Core Concepts — Workspace, Repository, Dist, Package Object, Desired Membership, and Built Generation.

Managed workspaces require a local POSIX filesystem with advisory locks, fsync, and atomic rename semantics. Metadata generation is in-process; optional RPM package signing needs rpm, while an agent:// metadata key needs gpg and gpg-agent.

Installation

Install SOW from an archive, RPM/DEB package, or source, then verify the binary and filesystem requirements.

Quick Start

Index a directory of RPM and DEB packages, serve it, and configure a client.

Your First Workspace

Create a workspace with RPM and DEB Dists, add packages, and verify the public tree.

Core Concepts

The SOW model: Plain and Managed execution, pools and views, Desired Membership, and Built Generations.