Skip to content

Download matrix

Download SOW

One self-contained CLI, five installation paths. Choose a package or archive for your operating system and architecture, or build from source. Pinned artifacts are enabled after their GitHub Release is public; the Pigsty repository follows its own update schedule.

SOW 0.5.0 · Linux · macOS · amd64 / arm64 · RPM + DEB · Apache-2.0

Install matrix

Pick the route that matches the host

Commands and links use the selected release version. Verify downloaded files against SHA256SUMS from that same release. The Pigsty repository is a rolling channel; the other paths pin the version shown above.

The shortest route on a Linux host: SOW ships in the Pigsty infra repository, so sow installs and upgrades with everything else the box already gets from APT or YUM. Mainland China is served by the repo.pigsty.cc mirror.

APT · Debian / Ubuntu
sudo tee /etc/apt/sources.list.d/pigsty-infra.list > /dev/null <<'EOF'
deb [trusted=yes] https://repo.pigsty.io/apt/infra generic main
EOF

sudo apt update
sudo apt install -y sow
YUM · RHEL / Rocky / Alma / Anolis
sudo tee /etc/yum.repos.d/pigsty-infra.repo > /dev/null <<'EOF'
[pigsty-infra]
name=Pigsty Infra for $basearch
baseurl=https://repo.pigsty.io/yum/infra/$basearch
enabled=1
gpgcheck=0
module_hotfixes=1
EOF

sudo dnf makecache
sudo dnf install -y sow
Mainland China mirror
# Same paths, different host: repo.pigsty.io -> repo.pigsty.cc

# APT
sudo sed -i 's|repo.pigsty.io|repo.pigsty.cc|' /etc/apt/sources.list.d/pigsty-infra.list
sudo apt update

# YUM
sudo sed -i 's|repo.pigsty.io|repo.pigsty.cc|' /etc/yum.repos.d/pigsty-infra.repo
sudo dnf makecache

Pinned native packages for an offline or promotion-gated pipeline. They carry the 1PGSTY release suffix, install the executable at /usr/bin/sow, and ship the Apache-2.0 licence and third-party notices.

RPM / DEB
RPM · x86_64 / aarch64
ARCH=$(uname -m)
curl -fLO "https://github.com/pgsty/sow/releases/download/v0.5.0/sow-0.5.0-1PGSTY.$ARCH.rpm"
sudo rpm -Uvh "sow-0.5.0-1PGSTY.$ARCH.rpm"
DEB · amd64 / arm64
ARCH=$(dpkg --print-architecture)
curl -fLO "https://github.com/pgsty/sow/releases/download/v0.5.0/sow_0.5.0-1PGSTY_$ARCH.deb"
sudo apt install "./sow_0.5.0-1PGSTY_$ARCH.deb"

Installer-free binaries for Linux and macOS on amd64 and arm64, for CI, for macOS workstations, and for hosts where you own the install path. Each archive holds the sow executable, README.md, CHANGELOG.md, the Apache-2.0 LICENSE, and THIRD_PARTY_NOTICES. Windows is not a release target.

Linux · amd64
# Swap linux_amd64 for linux_arm64, darwin_amd64, or darwin_arm64.
curl -fLO https://github.com/pgsty/sow/releases/download/v0.5.0/sow_0.5.0_linux_amd64.tar.gz
tar -xzf sow_0.5.0_linux_amd64.tar.gz
sudo install -m 0755 sow /usr/local/bin/sow

sow version
macOS · Apple Silicon
curl -fLO https://github.com/pgsty/sow/releases/download/v0.5.0/sow_0.5.0_darwin_arm64.tar.gz
tar -xzf sow_0.5.0_darwin_arm64.tar.gz
mkdir -p ~/.local/bin
install -m 0755 sow ~/.local/bin/sow

sow help

Build the tag yourself. The module declares Go 1.27.1, metadata generation needs no C toolchain, and these are the flags the release pipeline uses, so a source build reports the same product version as the published one.

Source
Clone, check out, build
git clone https://github.com/pgsty/sow.git
cd sow
git checkout v0.5.0

CGO_ENABLED=0 go build -trimpath \
  -ldflags="-s -w -X github.com/pgsty/sow/internal/v2cli.Version=0.5.0" \
  -o sow ./cmd/sow
sudo install -m 0755 sow /usr/local/bin/sow

The release’s SHA256SUMS lists the exact SHA-256 digest of each archive, RPM, and DEB. Download it alongside your artifact and verify the matching entry before installation. Keep the file name and release version together.

SHA256SUMS
Verify one artifact
ASSET=sow_0.5.0_linux_amd64.tar.gz
curl -fLO https://github.com/pgsty/sow/releases/download/v0.5.0/SHA256SUMS

# Linux
grep "  $ASSET$" SHA256SUMS | sha256sum -c -
# macOS
grep "  $ASSET$" SHA256SUMS | shasum -a 256 -c -

Then what

Where to go from here

Start

Quick Start

Turn a directory of RPM and DEB files into a usable flat repository in five steps.

Read

Start

First Workspace

Move from a Plain directory to a Managed workspace with membership, policy, and generations.

Read

Reference

CLI Reference

Syntax, selection rules, output, state transitions, and exit behavior for every command.

Read

Tutorial

Serve a repository

Publish the generated public tree with the HTTP server you already operate.

Read

Reference

Compatibility

Which distributions, package clients, and object-storage targets are covered.

Read

History

Release notes

What changed in each tag, in both languages, with its artifacts and upgrade notes.

Read

Installed? Build the first repository.