cli on PIG

pig v1.8.1

Thu, 03 Sep 2026 00:00:00 +0000

Pig v1.8.1 is a safety, correctness, and maintenance release on top of v1.8.0. It hardens command initialization, privileged log access, repository and build workflows, release integrity, and structured-output redaction. It also refreshes the embedded extension catalog and moves the build toolchain to Go 1.27.1 and cargo-pgrx 0.19.2. The embedded Pigsty version remains 4.5.0.

CLI safety and correctness

Read-only and configuration-independent commands no longer require a writable HOME or create ~/.pig as a side effect. Leaf commands preserve their declared initialization policy.
pig pg log, pig pt log, and pig pb log preserve arguments through sudo execution as the database OS user and reject unsafe log-file links.
pig do validates Pigsty names and rejects reserved Ansible cluster targets before execution.
Native PostgreSQL role detection is bound to the selected instance rather than an unrelated local default.
Structured results redact credentials, license material, and build-proxy identifiers while retaining truthful command failure.

Repository and build hardening

Repository add and remove operations now fail when any requested operation fails, deduplicate module selections, and preserve replacement boundaries.
Offline cache bundles reject unsafe paths, links, special files, and incomplete inputs; archive extraction remains rooted and fail-closed. The obsolete exported cache wrapper was removed after production moved to the structured result path.
Build source and artifact validation rejects incomplete or unsafe inputs. pig build proxy uses the package-provided service contract, treats its operands as optional, and keeps secret identifiers out of structured output.
Self-update verifies release checksums, and release tooling refuses dirty or mismatched-tag publication and immutable artifact replacement.

Toolchain and catalog

Go is updated to 1.27.1; Logrus to 1.10.2; GoReleaser to 2.18.0; and golangci-lint to 2.13.2.
pig build pgrx now installs cargo-pgrx 0.19.2 by default. Use -v when an extension requires an older pgrx line recorded in its catalog metadata.
The embedded catalog is refreshed from the maintained pgext view. It adds acdat 0.1.0, marks the superseded pgcontext_pgvector entry removed, and updates package versions, repository ownership, PostgreSQL coverage, and availability matrices.

Verification

The release is built from source commit e3d1eb4. The exact commit passed the full CI workflow, including randomized tests, command race regressions, vet, static analysis, dead-code detection, vulnerability scanning, and a GoReleaser snapshot. The tag then passed the Release workflow, which produced the published RPM, DEB, macOS, and Linux artifacts.

From Human-Friendly to Agent-Native: PIG's CLI Contract

Thu, 12 Feb 2026 00:00:00 +0000

Decision date: 2026-02-12
Status: Implemented in pig v1.1.0 and refined by later command-layer work.
Current reference: pig command overview
Scope: PIG-owned commands and their machine-consumption contract; opaque passthrough commands keep their native interface.

Decision

PIG should be usable by a person at a terminal and by an automation agent without making either consumer parse the other’s presentation. Human-facing text remains concise and operational. Commands that own a stable result expose explicit JSON or YAML results, status codes, and plans. Commands that merely forward an external tool preserve that tool’s native stream, prompts, and exit status instead of wrapping them in a misleading envelope.

pig v1.6.0

Tue, 28 Jul 2026 00:00:00 +0000

Pig v1.6.0 is a major release: pig pt becomes a transparent patronictl launcher, the new root-level pig inventory command group brings lossless editing and validation of pigsty.yml (with an experimental PostgreSQL CMDB bridge), pig sty grafana adds native Grafana dashboard management, and the packaged extension catalog grows to 562.

Highlights

pig pt is rewritten as a native patronictl passthrough: all cluster commands (list, restart, switchover, failover, edit-config, …) forward directly with native flags, prompts, output, and exit codes, so new patronictl features work without waiting for a pig release. Local helpers status, log, set, and service/svc remain, with new -c/--config-file, -d/--dcs-url, -k/--insecure options and a pig pt -- … escape hatch.
New root-level pig inventory command group (alias inv): status / list / show / edit / validate / check / diff — a lossless YAML engine that preserves comments, formatting, key order, and anchors byte-for-byte; edit validates before writing and writes atomically, so invalid YAML can never reach disk.
New experimental pig inventory cmdb subcommands (check / init / load / dump / enable / disable) exchange the inventory with the Pigsty CMDB in PostgreSQL over a native driver, with bounded timeouts and digest-pinned confirmation for destructive operations.
New pig sty grafana (alias gf) manages Grafana dashboards natively over HTTP: info / list / boot / load / init / dump / clean / lang / style. The pig sty surface is simplified: sty edit / validate / check / cmdb / dashboard / release are removed in favor of pig inventory, pig sty grafana, and pig sty list / get.
Reliability hardening: repo / catalog / download writes are atomic (no more truncated files on interrupt); structured -o json|yaml keeps stdout as a pure result envelope with wrapped-tool output on stderr; finer exit codes (usage errors → 2, missing --yes confirmation → 7); Ansible list variables are JSON-encoded.
Repository refresh: MySQL repos upgraded to 8.4 LTS, new Percona XtraBackup (pxb84) and MySQL Tools repos, Kubernetes v1.36, LLVM apt coverage for Debian/Ubuntu 26, Percona TDE sourced directly from repo.percona.com, wiltondb repo removed.
Toolchain: Go 1.26.5, new native PostgreSQL driver (pgx v5), embedded Pigsty version 4.4.0.

Extension Catalog

Packaged extensions: 531 -> 562; the broader PGEXT.CLOUD directory contains 2,230 entries.
33 new extensions, including the pg_lake family (pg_lake, pg_lake_table, pg_lake_engine, pg_lake_iceberg, pg_lake_copy), pg_jieba, pg_cjk_parser, pg_fts, pgmonitor, pgmemento, pg_tiktoken_c, online_advisor, pgsqlmock, and plx.
2 removed: pg_analytics, spat; 58 version refreshes, including vector 0.8.5, timescaledb 2.28.3, pg_search 0.24.3, pg_tde 2.2.1, and powa 5.2.0.
Package aliases synced with Pigsty: kafka is renamed to kafka-stack; the Debian/Ubuntu postgresql alias now maps to postgresql-$v only (use pgsql / pgsql-full for the full dev set).

Compatibility Notes

⚠ pig pt failover <name>: the positional argument is now the cluster, not the promotion candidate — use pig pt failover CLUSTER --candidate MEMBER and review any failover automation before upgrading.
pig pt positionals are native cluster-first (restart CLUSTER [MEMBER]); forwarded commands return native patronictl exit codes, own their confirmation prompts (-y no longer gates them), and no longer support -o json (use native --format json). pig pt config is replaced by pig pt set K=V and native show-config / edit-config.
In structured output mode, wrapped-tool output moves to stderr and stdout carries only the JSON/YAML envelope — update scripts that parsed mixed output.
pig inventory edit tightens the inventory file mode to 0600 after a successful edit, since the file may contain credentials.

Checksums

| File | Checksum | | --- | --- | | [pig\-1\.6\.0\-1\.aarch64\.rpm](https://github.com/pgsty/pig/releases/download/v1.6.0/pig-1.6.0-1.aarch64.rpm) | SHA-256 · `6899e8a3e1c0adfe8c0c177c0632b0a00821b304ed5998fcbdf28d02660c6768` | | [pig\-1\.6\.0\-1\.x86\_64\.rpm](https://github.com/pgsty/pig/releases/download/v1.6.0/pig-1.6.0-1.x86_64.rpm) | SHA-256 · `cabe593fe7f5c31cdbcd8d546ae4925b57f98f70c564452335568389f3f9737c` | | [pig\-v1\.6\.0\.darwin\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.6.0/pig-v1.6.0.darwin-amd64.tar.gz) | SHA-256 · `1f46d4a0b4710eed06b2cf8e7e17ee04b8d65331697c5c65afd513cc28282231` | | [pig\-v1\.6\.0\.darwin\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.6.0/pig-v1.6.0.darwin-arm64.tar.gz) | SHA-256 · `845decb95697fc68bc5e12bc80cecfd4c6d23160afee96568b699d82f2e9261d` | | [pig\-v1\.6\.0\.linux\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.6.0/pig-v1.6.0.linux-amd64.tar.gz) | SHA-256 · `4f1bb4fda8131db9f40db15e1575a6045b373dee609250cf5ee2bdedc2db89e2` | | [pig\-v1\.6\.0\.linux\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.6.0/pig-v1.6.0.linux-arm64.tar.gz) | SHA-256 · `4384d11150e31d614ed4ac3de4d6bf7ee7fa111ac84f5575753bb9f2f31f4ed8` | | [pig\_1\.6\.0\-1\_amd64\.deb](https://github.com/pgsty/pig/releases/download/v1.6.0/pig_1.6.0-1_amd64.deb) | SHA-256 · `e35ef0f2c76afe5f3512d34c0440abd8c0106c0e2775c5452e167ae3a4127e8e` | | [pig\_1\.6\.0\-1\_arm64\.deb](https://github.com/pgsty/pig/releases/download/v1.6.0/pig_1.6.0-1_arm64.deb) | SHA-256 · `c3bc6d04c6acd7e5c3164a33b7525b25a93e2de9822ce957c15c18ee0d551901` |

v1.6.0 · 2026-07-28

Why PIG Keeps the Cobra Command Layer Flat

Tue, 30 Jun 2026 00:00:00 +0000

Decision date: 2026-06-30
Status: Active repository architecture.
Current reference: pig command overview and the source repository
Scope: Go source ownership and command registration, not the public command taxonomy itself.

Decision

The cmd package stays flat. One top-level command belongs in one top-level Go file: pg.go, pb.go, pt.go, pe.go, sty.go, do.go, repo.go, and their peers. Even large command trees remain in that entry-point file unless there is an explicit decision to change the layout.

One Grammar for Dangerous Work: PIG's Operations CLI Safety Contract

Thu, 02 Jul 2026 00:00:00 +0000

Decision date: 2026-07-02
Status: Released for pg, pb, pt, and pitr by v1.5.0; the 2026-08-29 do and build proxy refinements were released in v1.8.1.
Current reference: pig pg, pig pb, pig pitr, pig do, and pig build
Scope: PIG-owned operational commands; transparent upstream commands retain upstream confirmation and exit behavior.

Decision

Operational convenience must not blur operational meaning. PIG distinguishes low-level primitives from multi-stage orchestrators, makes destructive intent explicit, reserves aliases carefully, and requires plans and structured results to describe the same action that text mode will execute.

Let Patronictl Speak for Itself

Tue, 21 Jul 2026 00:00:00 +0000

Decision date: 2026-07-21
Status: Implemented and released in pig v1.6.0.
Current reference: pig pt
Scope: Patronictl-backed cluster commands plus PIG-owned configuration selection, settings sugar, service, status, and log helpers.

Decision

pig pt is a transparent launcher for the installed patronictl. PIG selects the configuration and dispatches a small set of local helpers. Every other command token and all following arguments are passed unchanged, with native prompts, terminal behavior, output formats, and exit codes.

PIG 2.0 Product Direction: A Proposal, Not a Release Contract

Thu, 13 Aug 2026 00:00:00 +0000

Decision date: 2026-08-13
Status: Proposal for owner review; it is not implemented and is not a PIG 2.0 release commitment.
Current reference: PIG documentation and the current v1.8.1 release
Scope: Candidate product boundaries and verification gates for a future PIG 2.0 / Pigsty 5.0 line.

Decision

The proposed direction makes PIG the stable onboarding front door from an empty controller to a validated, deployable Pigsty Inventory. PIG would own Catalog selection, resolution, plans, bounded execution orchestration, structured results, and redacted receipts. It would continue to delegate package transactions, configuration application, and infrastructure state to DNF/APT, Ansible, and future provider-specific tools.

Catalog v2 Proposal: Immutable Typed Snapshots Instead of Bigger CSV

Thu, 13 Aug 2026 00:00:00 +0000

Decision date: 2026-08-13
Status: Pre-implementation proposal; security mechanism, overlay scope, packaging, and path ADRs remain open.
Current reference: pig ext and pig repo describe the v1 Catalog behavior.
Scope: A candidate PIG 2.0 publication and consumption model for product metadata, not Inventory or live system state.

Decision

Catalog v2 should be one immutable, verifiable snapshot composed of multiple typed targets. A manifest binds platform, repository, route, package-alias, extension, compatibility, Pigsty release, and public-key metadata to exact bytes. Candidate targets are validated together and activated through one pointer, preventing a new repository catalog from being mixed silently with an old extension matrix.

pig

Mon, 01 Jan 0001 00:00:00 +0000

The pig CLI provides a comprehensive toolkit for managing PostgreSQL installations, extensions, repositories, and extension builds from source. Use pig help <command> to view command documentation.

pig repo: manage software repositories
pig ext: manage PostgreSQL extensions
pig build: build extensions from source
pig install: install packages with the native package manager and translate PostgreSQL aliases
pig sty: manage Pigsty installation and Grafana dashboards
pig inventory: inspect, edit, validate, and exchange the Pigsty inventory (new in v1.6.0)
pig do: run Pigsty administration playbook tasks
pig pe: access pg_exporter metrics and configuration
pig pg: manage local PostgreSQL servers
pig pt: run patronictl transparently with service and config helpers
pig pb: manage pgBackRest backup and restore
pig pitr: run the full PITR workflow
pig context: output an environment context snapshot for humans and agents
pig status / update / version: inspect environment status, upgrade pig, and print version information

Overview

pig - The Linux package manager for PostgreSQL

Usage:
  pig [command]

Examples:

  pig repo add -ru            # overwrite existing repo and update cache
  pig install pg18            # install PostgreSQL 18 PGDG packages
  pig install pg_duckdb       # install a specific PostgreSQL extension
  pig install pgactive -v 18  # install extension for a specific PG version

  visit https://pigsty.io/ext/ for details

PostgreSQL Extension Manager
  build       Build Postgres extensions
  ext         Manage PostgreSQL extensions (pgext)
  repo        Manage Linux software repo (apt/dnf)

Pigsty Management Commands
  context     Show environment context snapshot
  do          Run admin tasks
  inventory   Inspect, edit, validate, check, and exchange Pigsty Inventory
  patroni     Run patronictl with Pigsty service and config helpers (alias: pt)
  pg_exporter Manage pg_exporter and metrics (alias: pe)
  pgbackrest  Manage pgBackRest backup and restore (alias: pb)
  pitr        Point-in-time recovery using pgBackRest
  postgres    Manage local PostgreSQL server and databases (alias: pg)
  sty         Manage Pigsty installation and controller services

Additional Commands:
  completion  Generate shell completion scripts
  help        Help about any command
  install     Install packages using native package manager
  status      Show environment status
  update      Upgrade pig itself
  version     Show pig version info

Flags:
      --debug              enable debug mode
  -h, --help               help for pig
  -H, --home string        Pigsty home path
  -i, --inventory string   config inventory path
      --log-level string   log level: debug, info, warn, error, fatal, panic (default "info")
      --log-path string    log file path, terminal by default
  -o, --output string      output format: text, yaml, json, json-pretty (default "text")

Use "pig [command] --help" for more information about a command.

pig repo

Manage APT/YUM repositories for PostgreSQL packages. See pig repo for details.

pig v1.3.0

Fri, 27 Feb 2026 00:00:00 +0000

This release is a focused engineering update from v1.2.0 to v1.3.0: 15 commits, 74 files changed, +1184 / -236 LOC.

It hardens the pig build pipeline and extends catalog/alias coverage, increasing total extensions from 451 to 461.

Highlights

Build source download improvements (pig build get):
- Parse multi-source Source fields (whitespace/newline/tab) and deduplicate entries.
- Add source mappings for agensgraph / agentsgraph.
- pgedge now downloads both postgresql-17.9.tar.gz and spock-5.0.5.tar.gz.
Dependency resolution and install improvements (pig build dep):
- RPM dependencies can infer PG major from pgmajorversion in spec files; missing spec/control files now return explicit errors.
- DEB dependency parsing now covers Build-Depends / Build-Depends-Arch / Build-Depends-Indep, including multiline fields, alternatives, arch qualifiers, and build-profile cleanup.
- PGVERSION placeholders can be expanded from --pg, installed PG majors, or extension metadata.
- Dependency install failures are downgraded to warnings so batch runs continue.
DEB build result semantics fixed (pig build ext/pkg):
- Successful build command exit code is authoritative; artifact discovery is best-effort warning only.
- Suppress empty package-list banners on successful no-artifact runs.
- Partial artifacts are warnings, not failures.
- Build logs now print real metadata source/version values instead of always composing name-version.
Better machine-readable ext operation output (pig ext rm/update):
- After alias resolution, removed/updated now returns resolved package names instead of extension aliases.
Extension catalog and alias updates:
- New aliases: agensgraph / agens, pgedge, babelfishpg.
- openhalodb is aligned to PG14 package naming; ivorysqldb naming is aligned.
- Fork metadata and availability matrix were refreshed in batch (including timescaledb, pgmq, orioledb, documentdb, pg_tde, and babelfishpg_* entries).
Engineering and release:
- Version bumped to v1.3.0 (including a v1.2.1 transition commit), copyright year moved to 2026, and README refreshed for 461 extensions and current alias docs.

Compatibility Notes

Structured removed/updated fields in pig ext rm/update now contain package names. Automation that matched extension aliases should update parsing logic.

New Extensions (451 -> 461)

Extension	Version	Notes
`aux_mysql`	1.5	openHalo MySQL compatibility helper (PG14)
`gb18030_2022`	1.0	IvorySQL charset conversion module
`ivorysql_ora`	1.0	IvorySQL Oracle compatibility extension
`ora_btree_gin`	1.0	Oracle datatype GIN indexing support
`ora_btree_gist`	1.0	Oracle datatype GiST indexing support
`pg_get_functiondef`	1.0	Function definition utility
`plisql`	1.0	PL/iSQL procedural language
`snowflake`	2.4	pgEdge Snowflake-style ID generator
`spock`	5.0.5	pgEdge multi-master logical replication extension
`lolor`	1.2.2	pgEdge logical-replication-friendly large objects

Full Commit List (`v1.2.0..v1.3.0`)

b8ecf8d bump version string to 1.2.1
55df9a4 build/get: support multi-source parsing and pgedge spock tarball
da8e347 add agensgraph and pgedge alias
86edbd7 ext: show resolved package names in rm/update results
ef3c905 build/dep: improve rpm/deb dependency resolution
7144e09 ext/catalog: refresh fork metadata and matrix entries
befffbf build(deb): treat successful build command as authoritative result
33fd517 build(deb): avoid empty package list banner on successful no-artifact runs
3b450f2 avoid concat ext pkg name with version when download
33847ab fix(ext): satisfy staticcheck S1011 in rm/update
b8b917d build(dep): treat dependency install failures as warnings
8110c00 adjust ivorysqldb babelfishpg alias
fac9faf bump version to 1.3.0
1f88f06 chore: update copyright year to 2026
c804757 v1.3.0

Checksums

| File | Checksum | | --- | --- | | [pig\-1\.3\.0\-1\.aarch64\.rpm](https://github.com/pgsty/pig/releases/download/v1.3.0/pig-1.3.0-1.aarch64.rpm) | SHA-256 · `e8409cc8165139028323094bebede495d4b0d0a52616d1aecd8c7ecd3fb7471d` | | [pig\-1\.3\.0\-1\.x86\_64\.rpm](https://github.com/pgsty/pig/releases/download/v1.3.0/pig-1.3.0-1.x86_64.rpm) | SHA-256 · `73645ea4b9ce27b44b2c7f4587e6218cdbbba045f32dd45c942e03cf9020c61e` | | [pig\-v1\.3\.0\.darwin\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.3.0/pig-v1.3.0.darwin-amd64.tar.gz) | SHA-256 · `a2d8a14b11606f4a23ca7b929686ff020fc8ce29e7cec21074f710f981aee6d4` | | [pig\-v1\.3\.0\.darwin\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.3.0/pig-v1.3.0.darwin-arm64.tar.gz) | SHA-256 · `fffb94bfc1808b45d8bef3fb63783c1a8e78057e0315ab5b8752088e2c9a555f` | | [pig\-v1\.3\.0\.linux\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.3.0/pig-v1.3.0.linux-amd64.tar.gz) | SHA-256 · `27220509c22d26eb8821ac189b1de9c4745adc0a0d91719df7d0b1fc1176b765` | | [pig\-v1\.3\.0\.linux\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.3.0/pig-v1.3.0.linux-arm64.tar.gz) | SHA-256 · `d124450333e61a5c7d0ed387b13b4087cfd2a81a3fde018232e6bf9b4db6ba0e` | | [pig\_1\.3\.0\-1\_amd64\.deb](https://github.com/pgsty/pig/releases/download/v1.3.0/pig_1.3.0-1_amd64.deb) | SHA-256 · `54f3e0561286b3c0af122137fd475213eff54bc82c69b8b46d1148112ab45b80` | | [pig\_1\.3\.0\-1\_arm64\.deb](https://github.com/pgsty/pig/releases/download/v1.3.0/pig_1.3.0-1_arm64.deb) | SHA-256 · `beb8ff31d1e64dbfcf6896115e6d200d835fc28bbac5a5b92d75096ef1e68c80` |

v1.3.0 · 2026-02-27

pig v1.2.0

Mon, 23 Feb 2026 00:00:00 +0000

Extension catalog and alias resolution enhancements:
- Introduce dynamic PG category alias resolution by PG major version.
- Add OS-level alias overrides (ansible/bootstrap) and converge unknown distro fallback to PGDG-only.
- Add aliases such as node/infra and babelfish/cloudberry, and refresh extension metadata to reduce package resolution ambiguity.
Plan preview for high-risk operations:
- Add pig install --plan with structured execution plan output.
- Align preview semantics for pig pitr and pgBackRest repack/expire under --plan / --dry-run.
- Add plan-flag consistency tests to keep subcommand behavior aligned.
Native sty configuration capability:

pig v1.1.0

Thu, 12 Feb 2026 00:00:00 +0000

This version is a planned architecture-level upgrade from v1.0.0 to v1.1.0 (79 commits, 193 files changed), with the core goal of moving pig from a “human-friendly CLI” to an “agent-native orchestratable CLI”.

Seven new extensions are added, bringing the total available extensions to 451.

New Features

Land the unified agent-native output framework: introduce global --output (text/yaml/json/json-pretty), and provide unified Result structure, stable status codes, and machine-readable output for ext/repo/pg/pt/pb/pitr/status/version/context.
Introduce ANCS (Agent Native Command Schema) metadata: add semantic fields such as type/volatility/parallel/risk/confirm/os_user/cost, and make help emit a command capability tree directly in structured mode for agent-side capability and risk discovery.
Add pig context (pig ctx) environment snapshot command: aggregate host, PostgreSQL, Patroni, pgBackRest, and extension information in one call for direct agent workflow context injection.
Expand plan capabilities beyond PITR: add pig ext add/rm --plan, pig pg stop/restart --plan, pig pt switchover/failover --plan, and align with pig pitr --plan/--dry-run into a reviewable execution plan format (actions, scope, risks, expected outcomes).
Further improve structured result coverage: embed native pgbackrest info JSON, and unify structured return DTOs across Patroni/PostgreSQL/PITR/Repo/Ext subsystems for automation compatibility.
Strengthen compatibility layer: add legacy structured wrappers for existing command groups such as pg_exporter/pg_probe/do/sty, preserving legacy interaction behavior while exposing structured execution results and output capture.
Update pigsty to v4.1.0.

Extension Update

Extension	Old	New
timescaledb	2.24.0	2.25.0
citus	14.0.0-2	14.0.0-3
pg_incremental	1.2.0	1.4.1
pg_bigm	1.2-20240606	1.2-20250903
pg_net	0.20.0	0.20.2
pgmq	1.9.0	1.10.0
pg_textsearch	0.4.0	0.5.0
pljs	1.0.4	1.0.5
sslutils	1.4-1	1.4-2
table_version	1.11.0	1.11.1
supautils	3.0.2	3.1.0
pg_math	1.0	1.1.0
pgsentinel	1.3.1	1.4.0
pg_uri	1.20151224	1.20251029
pgcollection	1.1.0	1.1.1
pg_readonly	1.0.3	1.0.4
timestamp9	1.4.0-1	1.4.0-2
pg_uint128	1.1.1	1.2.0
pg_roaringbitmap	0.5.5	1.1.0
plprql	18.0.0	18.0.1
pglinter	1.0.1	1.1.0
pg_jsonschema	0.3.3	0.3.4
pg_anon	2.5.1	3.0.1
vchord	1.0.0	1.1.0
pg_search	0.21.4	0.21.6/0.21.7
pg_graphql	1.5.12-1	1.5.12-2
pg_summarize	0.0.1-2	0.0.1-3
nominatim_fdw	-	1.1.0
pg_utl_smtp	-	1.0.0
pg_strict	-	1.0.2
pg_track_optimizer	-	0.9.1
pgmb	-	1.0.0

Bug Fixes

Security fix: resolve parsing panic in pig build proxy when receiving malformed proxy addresses.
Security fix: resolve path traversal risk in pig pg log, preventing access to files outside the log directory via ../../.
Security hardening: improve installer/repo path and quoting handling to reduce path injection and invalid-path misuse risks.
Build pipeline reliability fixes: correctly propagate errors and return non-zero exit codes in pig build get/pkg/ext when download/build fails; fix false failures in DEB builds caused by pg_ver mismatch.
Repo/catalog refresh fixes: support quiet mirror fallback for ext/repo reload; make repo add/set/rm return proper error status when cache updates fail.
Extension management fixes: adjust ext update to explicit-target updates and fix status drift issues; ensure ext import downloads requested DEB resources to the specified repo directory.
Output/observability fixes: align structured output exit code behavior with text mode rendering; improve permission handling and parsing stability in pg status.

Checksums

| File | Checksum | | --- | --- | | [pig\-1\.1\.0\-1\.aarch64\.rpm](https://github.com/pgsty/pig/releases/download/v1.1.0/pig-1.1.0-1.aarch64.rpm) | SHA-256 · `95245dc035270df2b02cdd5d19afac57ccf4949a61b07b1b806fffde3a3b780e` | | [pig\-1\.1\.0\-1\.x86\_64\.rpm](https://github.com/pgsty/pig/releases/download/v1.1.0/pig-1.1.0-1.x86_64.rpm) | SHA-256 · `8b1a26f1b5dd002841a0b31904eea8ce94d1e6c4acde4704a78d9e121e1656f4` | | [pig\-v1\.1\.0\.darwin\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.1.0/pig-v1.1.0.darwin-amd64.tar.gz) | SHA-256 · `dbd079510513f1cd0521b0871cc6fe3eed8f7fa26f66c04c682568c43e24c456` | | [pig\-v1\.1\.0\.darwin\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.1.0/pig-v1.1.0.darwin-arm64.tar.gz) | SHA-256 · `3f3ba081b54569a7de4d9a8fce72c02c84d9e1cbeb53173567f970c7291af251` | | [pig\-v1\.1\.0\.linux\-amd64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.1.0/pig-v1.1.0.linux-amd64.tar.gz) | SHA-256 · `ad61384bf01cbb8346ce869da0bc893203ad316c516fb9420cb748f1519a005e` | | [pig\-v1\.1\.0\.linux\-arm64\.tar\.gz](https://github.com/pgsty/pig/releases/download/v1.1.0/pig-v1.1.0.linux-arm64.tar.gz) | SHA-256 · `7713632beea1e6ca5c3e2e7172c4adee13a2b1b256755f6c2898b6ca98ee1e00` | | [pig\_1\.1\.0\-1\_amd64\.deb](https://github.com/pgsty/pig/releases/download/v1.1.0/pig_1.1.0-1_amd64.deb) | SHA-256 · `70cfc41b7b0aad48f29e12c22c34afd55b938bf50868ac8ab067b9cb62ccb867` | | [pig\_1\.1\.0\-1\_arm64\.deb](https://github.com/pgsty/pig/releases/download/v1.1.0/pig_1.1.0-1_arm64.deb) | SHA-256 · `fc5cf16671254f8f3495ff7e80c9d77d06b2328c1a247f90f96cf1e918e0ad0e` |

v1.1.0 · 2026-02-12

pig do

Mon, 01 Jan 0001 00:00:00 +0000

pig do exposes common Pigsty administrative playbooks as explicit CLI operations. It uses the selected Pigsty home and Inventory, builds the corresponding playbook command, and returns the operation through PIG’s legacy structured-result adapter.

These commands change remote systems. Review the selected cluster, node, instance, and Inventory before execution. The command family does not provide a general --plan mode.

pig do pgsql-add  pg-test 10.10.10.12     # add one PostgreSQL instance
pig do pgsql-rm   pg-test 10.10.10.12     # remove one PostgreSQL instance
pig do pgsql-db   pg-meta app             # create or update a database
pig do pgsql-user pg-meta dbuser_app      # create or update a user
pig do node-pkg   pg-meta restic          # install a package on selected nodes
pig do redis-add  redis-meta              # initialize a Redis cluster

Command overview

Command	Purpose	Required arguments
`pgsql-add`	Add a PostgreSQL cluster or instances	cluster, optional IPs
`pgsql-rm`	Remove a PostgreSQL cluster or instances	cluster, optional IPs
`pgsql-db`	Create or update a database declaration	cluster, database
`pgsql-user`	Create or update a user declaration	cluster, user
`pgsql-ext`	Install extensions through Pigsty	cluster, optional extensions
`pgsql-hba`	Refresh PostgreSQL HBA rules	cluster
`pgsql-svc`	Refresh PostgreSQL service definitions	cluster
`pgmon-add` / `pgmon-rm`	Add or remove a remote monitoring target	cluster
`node-add` / `node-rm`	Add or remove selected nodes	one or more selectors
`node-repo`	Configure repository modules on selected nodes	optional selector and modules
`node-pkg`	Install or update packages on selected nodes	selector, optional packages
`repo-build`	Rebuild the Pigsty infrastructure repository	none
`redis-add` / `redis-rm`	Add or remove Redis clusters, nodes, or instances	selector, optional ports

Run pig do COMMAND --help for the aliases and exact examples of one operation.

pig pe

Mon, 01 Jan 0001 00:00:00 +0000

pig pe (aliases: pgexp, pgexporter) is a legacy convenience wrapper for a running pg_exporter. It reads the default metrics and statistics endpoints and can request a configuration reload. It is not a general or versioned pg_exporter client.

pig pe get                     # print pg_ metrics
pig pe list                    # list metric families from HELP lines
pig pe stat                    # print exporter statistics
pig pe reload                  # request configuration reload

Endpoint selection

The default endpoint is http://127.0.0.1:9630. Select another exporter with persistent options:

Instantly Clone PostgreSQL Databases—No Black Magic Required

Mon, 06 Jul 2026 00:00:00 +0000

Six months ago, on January 8, 2026, I wrote Git for Data: Instant PostgreSQL Database and Instance Cloning, introducing a new feature in PostgreSQL 18 and Pigsty v4.0: instant database cloning. With filesystem copy-on-write (CoW) and PostgreSQL 18’s new file_copy_method = clone setting, you can clone a huge database in seconds without consuming additional storage.

This is a particularly good fit for AI agents. As I wrote in What Kind of Database Do AI Agents Need?, ultra-low-cost database cloning is critical for counterfactual experiments. So when Pigsty 4.0 shipped, I added this capability to its PostgreSQL database provisioning workflow.

PG Extension Cloud: Unlocking PostgreSQL’s Entire Ecosystem

Wed, 12 Nov 2025 00:00:00 +0000

WeChat link

PostgreSQL’s killer feature is extensibility. PostGIS, pgvector, pg_duckdb, pg_search—extensions turn PG into GIS engine, vector DB, analytics warehouse, search cluster. But compiling and shipping them reliably across distros is a nightmare, especially when official mirrors freeze or your network can’t reach upstream.

After two years of grinding, I’m launching PGEXT.CLOUD: the infrastructure for discovering, packaging, and installing PG extensions.

What’s inside

Extension catalog – Browse 431 extensions with metadata, docs, compatibility matrices, how-to guides. Think “Wikipedia for PG extensions.”
Binary repos – Native RPM/DEB packages for 14 Linux releases and 6 major PG versions. No Docker-only traps.
pig CLI – A 4 MB Go tool that wraps your existing package manager and hides the matrix of platforms/versions.

Try it on a fresh server/container:

Pig, The Postgres Extension Wizard

Sun, 29 Dec 2024 00:00:00 +0000

Ever wished installing or upgrading PostgreSQL extensions didn’t feel like digging through outdated readmes, cryptic configure scripts, or random GitHub forks & patches? The painful truth is that Postgres’s richness of extension often comes at the cost of complicated setups—especially if you’re juggling multiple distros or CPU architectures.

Enter Pig, a Go-based package manager built to tame Postgres and its ecosystem of 440+ extensions in one fell swoop. TimescaleDB, Citus, PGVector, 20+ Rust extensions, plus every must-have piece to self-host Supabase — Pig’s unified CLI makes them all effortlessly accessible. It cuts out messy source builds and half-baked repos, offering version-aligned RPM/DEB packages that work seamlessly across Debian, Ubuntu, and RedHat flavors. No guesswork, no drama.

cli on PIG

pig v1.8.1

CLI safety and correctness

Repository and build hardening

Toolchain and catalog

Verification

From Human-Friendly to Agent-Native: PIG's CLI Contract

Decision

pig v1.6.0

Highlights

Extension Catalog

Compatibility Notes

Checksums

Why PIG Keeps the Cobra Command Layer Flat

Decision

One Grammar for Dangerous Work: PIG's Operations CLI Safety Contract

Decision

Let Patronictl Speak for Itself

Decision

PIG 2.0 Product Direction: A Proposal, Not a Release Contract

Decision

Catalog v2 Proposal: Immutable Typed Snapshots Instead of Bigger CSV

Decision

pig

Overview

pig repo

pig v1.3.0

Highlights

Compatibility Notes

New Extensions (451 -> 461)

Full Commit List (v1.2.0..v1.3.0)

Checksums

pig v1.2.0

pig v1.1.0

New Features

Extension Update

Bug Fixes

Checksums

pig do

Command overview

pig pe

Endpoint selection

Instantly Clone PostgreSQL Databases—No Black Magic Required

PG Extension Cloud: Unlocking PostgreSQL’s Entire Ecosystem

What’s inside

Pig, The Postgres Extension Wizard

Full Commit List (`v1.2.0..v1.3.0`)