Skip to content

plain

11 pages
  • SOW v0.5.0

    By Vonng In Release 765 words 4 min

    VonngReleasereleaseplainyumsigningmigration

    SOW v0.5.0

    SOW 0.5.0 adds publication timestamps for existing YUM repositories and fixes Managed repository recovery, signing, and package-path handling. It also reduces repeated package verification during builds. Install the release from Download SOW. If you …

    SOW 0.5.0 adds publication timestamps for existing YUM repositories and fixes Managed repository recovery, signing, and package-path handling. It also reduces repeated package verification during builds. Install the release from Download SOW. If you …

  • SOW v0.3.0

    By Vonng In Release 605 words 3 min

    VonngReleasereleaseplainmanagedtransaction

    SOW v0.3.0

    SOW 0.3.0 reduced repeated package reads and database queries. Plain generation uses one pass over package content. Managed builds cache parsed package data and commit new pool files in batches. This release also removed retired runtime and …

    SOW 0.3.0 reduced repeated package reads and database queries. Plain generation uses one pass over package content. Managed builds cache parsed package data and commit new pool files in batches. This release also removed retired runtime and …

  • Design Principles

    By Vonng In Design 428 words 3 min

    VonngDesignplainmanagedrepository

    Design Principles

    SOW separates package storage, repository builds, and publication. These principles explain where each kind of state belongs and how operations use it. One owner for each record Record Owner Package bytes and identity Repository Desired membership …

    SOW separates package storage, repository builds, and publication. These principles explain where each kind of state belongs and how operations use it. One owner for each record Record Owner Package bytes and identity Repository Desired membership …

  • The v0.2 Reset: Plain and Managed Instead of a Universal Control Plane

    By Vonng In Design 1188 words 6 min

    VonngDesignhistoryv0.2plainmanagedarchitecturedecision

    The v0.2 Reset: Plain and Managed Instead of a Universal Control Plane

    On 2026-07-31, after sealing the v0.1 source baseline, SOW began a product reset. The goal was a small repository engine that could replace Pigsty’s daily package-build workflow. It kept the earlier lessons about integrity and recovery while removing …

    On 2026-07-31, after sealing the v0.1 source baseline, SOW began a product reset. The goal was a small repository engine that could replace Pigsty’s daily package-build workflow. It kept the earlier lessons about integrity and recovery while removing …

  • Core Concepts

    In Get Started

    Startplainmanagedrepositorydist

    Choose a mode Need Plain Managed Build indexes from a package directory sow create DIR Import packages with sow add Keep configuration and package membership Directory contents are the state sow.yml and private SQLite databases Organize packages One …

    Choose a mode Need Plain Managed Build indexes from a package directory sow create DIR Import packages with sow add Keep configuration and package membership Directory contents are the state sow.yml and private SQLite databases Organize packages One …

  • Features

    In Features

    Featureplainmanagedpolicysigning

    SOW creates repository indexes in two modes. Choose Plain for a directory you can rebuild. Choose Managed for ongoing package updates, policy, signing, and publication. Capabilities Capability Plain Managed RPM and DEB indexes One directory, either …

    SOW creates repository indexes in two modes. Choose Plain for a directory you can rebuild. Choose Managed for ongoing package updates, policy, signing, and publication. Capabilities Capability Plain Managed RPM and DEB indexes One directory, either …

  • Quick Start

    In Get Started

    Startplainrpmdebcli

    Use Plain mode to build a repository from a directory of packages. It works without a workspace or configuration file. You need SOW, Python 3 for the preview, and at least one RPM or DEB file. Prepare a directory Create a writable directory. Replace …

    Use Plain mode to build a repository from a directory of packages. It works without a workspace or configuration file. You need SOW, Python 3 for the preview, and at least one RPM or DEB file. Prepare a directory Create a writable directory. Replace …

  • Plain Flat Repositories

    In Features

    Featureplainrpmdeb

    Use sow create to build indexes for a directory of RPM or DEB packages. It writes the indexes beside the packages. It does not read sow.yml or create a state database. sow create /srv/offline Inputs and outputs SOW scans top-level regular files with …

    Use sow create to build indexes for a directory of RPM or DEB packages. It writes the indexes beside the packages. It does not read sow.yml or create a state database. sow create /srv/offline Inputs and outputs SOW scans top-level regular files with …

  • Migrate an Existing YUM Repository

    In Tutorials

    Tutorialyumplainmigrationsigning

    This guide covers a flat directory of RPMs and repodata/, such as a repository previously built with createrepo_c. It uses Plain sow create, without creating a Managed workspace. The publication-time option requires SOW 0.5.0 or later. 1. Prepare a …

    This guide covers a flat directory of RPMs and repodata/, such as a repository previously built with createrepo_c. It uses Plain sow create, without creating a Managed workspace. The publication-time option requires SOW 0.5.0 or later. 1. Prepare a …

  • Get Started

    In Get Started

    Startinstallplainmanaged

    SOW turns RPM and DEB files into static YUM and APT repositories. Install SOW, then choose how to manage your packages: Plain mode: run sow create DIR to build indexes for the packages in a directory. Managed mode: create a workspace to group …

    SOW turns RPM and DEB files into static YUM and APT repositories. Install SOW, then choose how to manage your packages: Plain mode: run sow create DIR to build indexes for the packages in a directory. Managed mode: create a workspace to group …

  • sow create

    In Commands

    Commandcliplainrpmdeb

    sow create writes RPM and DEB indexes beside the package files in a directory. Use it for a flat repository that does not need a managed Workspace. DIR defaults to the current directory. Synopsis sow create [DIR] [-j N] [--metadata-timestamp SECONDS] …

    sow create writes RPM and DEB indexes beside the package files in a directory. Use it for a flat repository that does not need a managed Workspace. DIR defaults to the current directory. Synopsis sow create [DIR] [-j N] [--metadata-timestamp SECONDS] …