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.6.1 · Linux · macOS · amd64 / arm64 · RPM + DEB · Apache-2.0

Published releases on GitHub Installation guide

Installation

Choose an installation method

Download SOW 0.6.1 packages and archives below. The Pigsty repository follows its 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.6.1/sow-0.6.1-1PGSTY.$ARCH.rpm"
sudo rpm -Uvh "sow-0.6.1-1PGSTY.$ARCH.rpm"
DEB · amd64 / arm64
ARCH=$(dpkg --print-architecture)
curl -fLO "https://github.com/pgsty/sow/releases/download/v0.6.1/sow_0.6.1-1PGSTY_$ARCH.deb"
sudo apt install "./sow_0.6.1-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.6.1/sow_0.6.1_linux_amd64.tar.gz
tar -xzf sow_0.6.1_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.6.1/sow_0.6.1_darwin_arm64.tar.gz
tar -xzf sow_0.6.1_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.3 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.6.1

SOW_BUILD_DIR="$(mktemp -d)"
CGO_ENABLED=0 go build -trimpath \
  -ldflags="-s -w -X github.com/pgsty/sow/internal/v2cli.Version=0.6.1" \
  -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.6.1_linux_amd64.tar.gz
curl -fLO https://github.com/pgsty/sow/releases/download/v0.6.1/SHA256SUMS

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

.rpm

FileChecksum
sow-0.6.1-1PGSTY.aarch64.rpm Linuxarm64SHA-256 12fc74b36235e4cc5d738d73d4aa4bb1bab096478effad09b5f53f85434c0334
sow-0.6.1-1PGSTY.x86_64.rpm Linuxamd64SHA-256 4a88084254c8857c615f968c986ae9f064a06b4e197068c393365c3a16280ffd

.deb

FileChecksum
sow_0.6.1-1PGSTY_amd64.deb Linuxamd64SHA-256 61811ed4fbc01e45b4e3cf02b442133273e47488dff4305b3554c87ce7980db5
sow_0.6.1-1PGSTY_arm64.deb Linuxarm64SHA-256 8153e1868e21f3e0be6eb95a003e55e391bd6458e87d0a80b194d660393c77cf

.tar.gz

FileChecksum
sow_0.6.1_darwin_amd64.tar.gz macOSamd64SHA-256 f0f092220d629285d64d0cb6defca0a9397e627855b252886a969f9fc1e78502
sow_0.6.1_darwin_arm64.tar.gz macOSarm64SHA-256 4a0e35d91d93d571883762a24f040f088c39c855b73e5db80fc92e1c03226415
sow_0.6.1_linux_amd64.tar.gz Linuxamd64SHA-256 8b173bf91d37501f4174b17f051d63bf6e078ccced6bce188d58f6ae5f385a6b
sow_0.6.1_linux_arm64.tar.gz Linuxarm64SHA-256 7553097c20d3e6b9c8943666e14506fd4f68ecef5d9985143a24066abb454815

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