Skip to content

Latest commit

 

History

39 Commits

Folders and files

Repository files navigation

PGSTY Infra

中文说明 · PGSTY

Homebrew formulae for PGSTY and infrastructure software. Release formulae pin native upstream binaries and SHA-256 checksums for Apple Silicon and Intel macOS, plus arm64 and x86_64 Linux.

Install

The source repository follows Homebrew's naming convention as pgsty/homebrew-infra, so the tap can be added with its short name:

brew tap pgsty/infra

brew install pgsty/infra/silo pgsty/infra/silo-console pgsty/infra/kes pgsty/infra/mcli
brew install pgsty/infra/pig
brew install pgsty/infra/alertmanager
brew install pgsty/infra/pgschema

Use fully qualified names for formulas that collide with Homebrew Core. In particular, pgsty/infra/pig is the PGSTY PostgreSQL CLI, while Core's pig is Apache Pig.

The agentsview release binaries require macOS 26 (Tahoe) or later on both Apple Silicon and Intel Macs.

Existing pgsty/tap installations keep working through GitHub's repository redirect. New installations and documentation use pgsty/infra as the canonical tap name.

PGSTY software

Formula Installed command Purpose Release source
silo silo S3-compatible object storage server pgsty/silo
silo-console silo-console Administrative web console pgsty/silo-console
kes kes Key encryption service for Silo pgsty/kes
mcli mcli Silo/S3 command-line client pgsty/mc
pig pig PostgreSQL extension package manager and CLI pgsty/pig
barn barn Native QEMU runtime for Pigsty development VMs; start with barn up, connect with barn ssh pgsty/barn
sow sow Local RPM/DEB repository manager pgsty/sow
pg-exporter pg_exporter PostgreSQL/PgBouncer Prometheus exporter pgsty/pg_exporter

The pgsty/mc client is packaged as mcli; both the formula and installed command use that name.

Install Barn's prebuilt release:

brew install pgsty/infra/barn

Homebrew installs the Barn CLI, its matching hosts helper, and QEMU. Go is not required. Barn 1.0.0 includes the signed, notarized native Barn.app on Apple Silicon. Homebrew installs it into the formula's private libexec directory, so barn mac discovers the matching runner automatically. macOS guests require Apple Silicon and macOS 27 or later; Linux guests use QEMU.

Barn 1.0.0 is the first stable release. The scheduled updater selects stable releases and refreshes all four platform assets and checksums together. Drafts and prereleases are excluded.

Additional infrastructure software

These projects come from the pgsty/infra-pkg catalog, publish native binaries for all four supported OS/CPU pairs, and are not already covered by Homebrew Core for the same project.

Formula Installed command(s) Purpose
agentsview agentsview Inspect AI coding-agent sessions and costs
alertmanager alertmanager, amtool Prometheus alert routing and management
blackbox-exporter blackbox_exporter HTTP, DNS, TCP, ICMP, and gRPC probing
headscale headscale Self-hosted Tailscale control server
kafka-exporter kafka_exporter Kafka Prometheus metrics exporter
loki-canary loki-canary End-to-end Loki availability validator
mongodb-exporter mongodb_exporter MongoDB Prometheus metrics exporter
mtail mtail Extract metrics from application logs
mysqld-exporter mysqld_exporter MySQL Prometheus metrics exporter
nginx-exporter nginx_exporter NGINX Prometheus metrics exporter
pg-timetable pg_timetable PostgreSQL job scheduler
pgbackrest-exporter pgbackrest_exporter pgBackRest Prometheus metrics exporter
pgbot pgbot PostgreSQL diagnostics and baseline comparisons
pggo pggo PostgreSQL CLI with JSON output for scripts and agents
pgschema pgschema Declarative PostgreSQL schema migration
pgterm pgterm PostgreSQL terminal workspace; includes the pgbot dependency
pushgateway pushgateway Prometheus gateway for short-lived jobs
redis-exporter redis_exporter Redis Prometheus metrics exporter
sabiql sabiql Terminal PostgreSQL client
sql-studio sql-studio Multi-database terminal SQL explorer
stalwart stalwart Mail and collaboration server
tigerbeetle tigerbeetle Financial transactions database
victoria-traces victoria-traces OpenTelemetry tracing backend
zfs-exporter zfs_exporter ZFS Prometheus metrics exporter

See CANDIDATES.md for the admission rules, equivalent Core formula names, and projects deferred because of incomplete macOS architecture coverage or extra kernel/runtime requirements.

Common operations

brew update
brew upgrade pgsty/infra/pig pgsty/infra/silo pgsty/infra/alertmanager
brew uninstall pgsty/infra/alertmanager
brew untap pgsty/infra

Silo includes an optional Homebrew service:

brew services start pgsty/infra/silo
brew services stop pgsty/infra/silo

Set production credentials before starting Silo. Run brew info pgsty/infra/silo for its data path and service notes.

Release integrity and updates

  • Release formulae pin one GitHub Release asset and SHA-256 for each supported OS/CPU pair.
  • The release updater ignores drafts and prereleases for every formula.
  • A source-only GitHub Release with no binary assets is skipped with a warning; a partially populated binary Release still blocks that Formula update.
  • A scheduled updater changes all four platform URLs and hashes atomically and opens a reviewable pull request only when versions change.
  • Homebrew CI explicitly runs style, cross-platform readall, and audit against pgsty/infra on every push. Pull requests and automated update branches also install and test every formula on Apple Silicon and Intel macOS, plus Linux.

See CONTRIBUTING.md for the maintenance workflow and SECURITY.md for reporting integrity or security issues.

Local validation

brew tap pgsty/infra /absolute/path/to/homebrew-infra
./scripts/check.sh

This checks Ruby syntax, updater invariants, current release metadata, Homebrew style, and strict online formula audits.

Releases

Packages

Contributors

Languages