Skip to content

SOW for Linux and macOS

Download SOW

Install from the Pigsty repository, download a versioned package or archive, or build from source. Choose the file for your operating system and architecture.

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

Published releases on GitHub Installation guide

Installation

Choose an installation method

The package and archive downloads below use SOW 0.5.0. The Pigsty repository provides its latest packaged version.

On Linux, install and update SOW with APT or DNF from the Pigsty infra repository. This channel follows the repository version. In mainland China, use the repo.pigsty.cc mirror. The APT example marks the source as trusted with trusted=yes. The DNF example disables RPM package signature checks with gpgcheck=0.

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

Use these packages to install a specific version or prepare an offline installation. They carry the 1PGSTY release suffix, install SOW 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"

Use an archive on Linux or macOS when you want to choose the installation directory. Builds are available for amd64 and arm64. Archives include the executable, documentation, and license files.

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

export PATH="$HOME/.local/bin:$PATH"
sow version
sow help

Install Go 1.27.1 or newer, then build the release tag with the commands below. No C compiler is required. The build flags set the version shown by sow version.

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

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

Download SHA256SUMS from the same release as your package or archive. Before installation, set ASSET to the downloaded file name and check its SHA-256 digest with the command for your operating system.

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 -

.rpm

FileChecksum
sow-0.5.0-1PGSTY.aarch64.rpm Linuxarm64SHA-256 98befda82b0a2a4bdfe9d8080d6527a7ce5ae3bc5774a060c2ef791900b38c7c
sow-0.5.0-1PGSTY.x86_64.rpm Linuxamd64SHA-256 a33c53761653831bcb3133d471aab2a294da2b4b0d3afb3cf192f7b84b256f80

.deb

FileChecksum
sow_0.5.0-1PGSTY_amd64.deb Linuxamd64SHA-256 85bc13065af8732658e22c505eab407175426215d73c499c3b3b4a7c1ba75eac
sow_0.5.0-1PGSTY_arm64.deb Linuxarm64SHA-256 2f783aaa55485f6c665f605e5b9e7c932d4265d07497a6a8a172eb2ac37a4ac1

.tar.gz

FileChecksum
sow_0.5.0_darwin_amd64.tar.gz macOSamd64SHA-256 65ba1f4a160f7515022a3639356ab6fa3ec191acb2d99d491330fcc1f6014dff
sow_0.5.0_darwin_arm64.tar.gz macOSarm64SHA-256 bb707c2506f408f9c4d14022e6e2e2a76ed130588f9527aa81ef79397d485efc
sow_0.5.0_linux_amd64.tar.gz Linuxamd64SHA-256 3e14f2b1ce9debb0cbe3cc1a8983f0c46b843caa05eb92911714dcfdf6630d32
sow_0.5.0_linux_arm64.tar.gz Linuxarm64SHA-256 cbc5a34118c438df0657e80074507e8db7a048754182bc088d46afb5a6b7d5a2

Next steps

Create and serve a repository

Start

Quick Start

Build a flat repository from a directory of RPM and DEB files.

Read

Start

First Workspace

Create a Managed workspace to select packages and keep build history.

Read

Reference

CLI Reference

Look up command syntax, options, output, and exit codes.

Read

Tutorial

Serve a repository

Configure an HTTP server so clients can download packages.

Read

Reference

Compatibility

Check supported platforms, repository formats, clients, and storage targets.

Read

History

Release notes

Read version changes and upgrade instructions.

Read

Build your first repository

Get Startedpgsty/sow