Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/pgsty/pig

PostgreSQL Extension Manager
https://github.com/pgsty/pig

cli debian extension installer package-manager postgresql rhel ubuntu

Last synced: 25 days ago
JSON representation

PostgreSQL Extension Manager

Awesome Lists containing this project

README 

        
# PIG - Postgres Install Genius



[![Catalog: pigsty.io](https://img.shields.io/badge/catalog-pigsty.io-slategray?style=flat&logo=cilium&logoColor=white)](https://pigsty.io/ext/list)

[![Version: v0.3.4](https://img.shields.io/badge/version-v0.3.4-slategray?style=flat&logo=cilium&logoColor=white)](https://github.com/pgsty/pig/releases/tag/v0.3.4)

[![Pigsty: v3.4.1](https://img.shields.io/badge/Pigsty-v3.4.1-slategray?style=flat&logo=cilium&logoColor=white)](https://pigsty.io)

[![License: Apache-2.0](https://img.shields.io/github/license/pgsty/pig?logo=opensourceinitiative&logoColor=green&color=slategray)](https://github.com/pgsty/pig/blob/main/LICENSE)

[![Extensions: 405](https://img.shields.io/badge/extensions-405-%233E668F?style=flat&logo=postgresql&logoColor=white&labelColor=3E668F)](https://pigsty.io/ext/list)



[**pig**](https://pigsty.io/ext/pig) is an open-source PostgreSQL (& Extension) Package Manager for [mainstream](#compatibility) (EL/Debian/Ubuntu) Linux.



Install PostgreSQL 13-17 along with [405 extensions](https://pigsty.io/ext/list) on (`amd64` / `arm64`) with native OS package manager



> Blog: [The idea way to deliver PostgreSQL extensions](https://medium.com/@fengruohang/the-idea-way-to-deliver-postgresql-extensions-35646464bb71)



[![PostgreSQL Extension Ecosystem](https://pigsty.io/img/pigsty/ecosystem.jpg)](https://medium.com/@fengruohang/postgres-is-eating-the-database-world-157c204dcfc4)



--------



## Get Started



[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-17,16,15,14,13-%233E668F?style=flat&logo=postgresql&labelColor=3E668F&logoColor=white)](https://pigsty.io/docs/pgsql)

[![Linux](https://img.shields.io/badge/Linux-amd64/arm64-%23FCC624?style=flat&logo=linux&labelColor=FCC624&logoColor=black)](https://pigsty.io/docs/node)

[![EL Support: 8/9](https://img.shields.io/badge/EL-8/9-red?style=flat&logo=redhat&logoColor=red)](https://pigsty.io/ext/feat/rpm)

[![Debian Support: 12](https://img.shields.io/badge/Debian-12-%23A81D33?style=flat&logo=debian&logoColor=%23A81D33)](https://pigsty.io/docs/reference/compatibility/)

[![Ubuntu Support: 22/24](https://img.shields.io/badge/Ubuntu-22/24-%23E95420?style=flat&logo=ubuntu&logoColor=%23E95420)](https://pigsty.io/ext/feat/deb)



[Install](#installation) the `pig` package first, (you can also use the `apt` / `yum` or just copy the binary)



```bash

curl -fsSL https://repo.pigsty.io/pig | bash

```



Then it's ready to use, assume you want to install the [`pg_duckdb`](https://pigsty.io/ext/feat/pg_duckdb) extension:



```bash

$ pig repo add pigsty pgdg -u  # add pgdg & pigsty repo, then update repo cache

$ pig ext install pg17         # install PostgreSQL 17 kernels with native PGDG packages

$ pig ext install pg_duckdb    # install the pg_duckdb extension (for current pg17)

```



That's it, All set! Check the [advanced usage](#advanced-usage) for details and [the full list 400+ available extensions](https://pigsty.io/ext/feat/list).



[![asciicast](https://asciinema.org/a/695902.svg)](https://asciinema.org/a/695902)



--------



## Installation



The `pig` util is a standalone go binary with no dependencies. You can install with the script:



```bash

curl -fsSL https://repo.pigsty.io/pig | bash   # cloudflare default

curl -fsSL https://repo.pigsty.cc/pig | bash   # mainland china mirror

```



Or just download and extract the binary, or use the `apt/dnf` package manager:

 

For Ubuntu 22.04 / 24.04 & Debian 12 or any compatible platforms:



```bash

sudo tee /etc/apt/sources.list.d/pigsty.list > /dev/null < /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 yum makecache; sudo yum install -y pig

```



> For mainland china user: consider replace the `repo.pigsty.io` with `repo.pigsty.cc`



`pig` has self update feature, you can update pig itself to the latest version with:



```bash

pig update

```



Or if you only want to update the extension catalog, you can fetch the latest catalog with:



```bash

pig ext upgrade

```



--------



## Advanced Usage



**Environment Status**



```bash

pig status                    # show os & pg & pig status

pig repo status               # show upstream repo status

pig ext  status               # show pg extensions status 

```



**Extension Management**



```bash

pig ext list    [query]       # list & search extension      

pig ext info    [ext...]      # get information of a specific extension

pig ext status  [-v]          # show installed extension and pg status

pig ext add     [ext...]      # install extension for current pg version

pig ext rm      [ext...]      # remove extension for current pg version

pig ext update  [ext...]      # update extension to the latest version

pig ext import  [ext...]      # download extension to local repo

pig ext link    [ext...]      # link postgres installation to path

pig ext upgrade               # fetch the latest extension catalog

```



**Repo Management**



```bash

pig repo list                    # available repo list

pig repo info   [repo|module...] # show repo info

pig repo status                  # show current repo status

pig repo add    [repo|module...] # add repo and modules

pig repo set    [repo|module...] # overwrite & update after add

pig repo rm     [repo|module...] # remove repo & modules

pig repo update                  # update repo pkg cache

pig repo create                  # create repo on current system

pig repo boot                    # boot repo from offline package

pig repo cache                   # cache repo as offline package

```



**Build Management**



```bash

pig build repo                   # init build repo (=repo set -ru)

pig build tool  [mini|full|...]  # init build toolset

pig build proxy [id@host:port ]  # init build proxy (optional)

pig build rust  [-v ]  # init rustc & pgrx (0.13.1)

pig build spec                   # init build spec repo

pig build get   [all|std|..]     # get ext code tarball with prefixes

pig build dep   [extname...]     # install extension build deps

pig build ext   [extname...]     # build extension

```



**Radical Repo Admin**



The default `pig repo add pigsty pgdg` will add the `PGDG` repo and [`PIGSTY`](https://pigsty.io/ext/usage/repo) repo to your system.

While the following command will backup & wipe your existing repo and add all require repo to your system.



```bash

pig repo add all --ru        # This will OVERWRITE all existing repo with node,pgdg,pigsty repo

pig repo set                 # = pig repo add all --update --remove

```



There's a brutal version of repo add: `repo set`, which will overwrite you existing repo (`-ru`) by default.



And you can recover you old repos at `/etc/apt/backup` or `/etc/yum.repos.d/backup`.



**Install PostgreSQL**



You can also install PostgreSQL kernel packages with



```bash

pig ext install pg17          # install PostgreSQL 17 kernels (all except test/devel)

pig ext install pg16-mini     # install PostgreSQL 16 kernels with minimal packages

pig ext install pg15 -y       # install PostgreSQL 15 kernels with auto-confirm

pig ext install pg14=14.3     # install PostgreSQL 14 kernels with an specific minor version

pig ext install pg13=13.10    # install PostgreSQL 13 kernels

```



You can link the installed PostgreSQL to the system path with:



```bash

pig ext link pg17             # create /usr/pgsql soft links, and write it to /etc/profile.d/pgsql.sh

. /etc/profile.d/pgsql.sh     # reload the path and take effect immediately

```



You can also use other package alias, it will translate to corresponding package on your OS distro

and the `$v` will be replaced with the active or given pg version number, such as `17`, `16`, etc...



```yaml

pg17:         "postgresql17 postgresql17-server postgresql17-libs postgresql17-contrib postgresql17-plperl postgresql17-plpython3 postgresql17-pltcl postgresql17-llvmjit"

pg17-client:  "postgresql17"

pg17-server:  "postgresql17-server postgresql17-libs postgresql17-contrib"

pg17-devel:   "postgresql17-devel"

pg17-basic:   "pg_repack_17* wal2json_17* pgvector_17*"

pg16-mini:    "postgresql16 postgresql16-server postgresql16-libs postgresql16-contrib"

pg15-full:    "postgresql15 postgresql15-server postgresql15-libs postgresql15-contrib postgresql15-plperl postgresql15-plpython3 postgresql15-pltcl postgresql15-llvmjit postgresql15-test postgresql15-devel"

pg14-main:    "postgresql14 postgresql14-server postgresql14-libs postgresql14-contrib postgresql14-plperl postgresql14-plpython3 postgresql14-pltcl postgresql14-llvmjit pg_repack_14* wal2json_14* pgvector_14*"

pg13-core:    "postgresql13 postgresql13-server postgresql13-libs postgresql13-contrib postgresql13-plperl postgresql13-plpython3 postgresql13-pltcl postgresql13-llvmjit"

```



More Alias



Take el for examples:



```yaml

pgsql-common:        "patroni patroni-etcd pgbouncer pgbackrest pg_exporter pgbadger vip-manager",

pgsql:               "postgresql$v postgresql$v-server postgresql$v-libs postgresql$v-contrib postgresql$v-plperl postgresql$v-plpython3 postgresql$v-pltcl postgresql$v-llvmjit"

pgsql-mini:          "postgresql$v postgresql$v-server postgresql$v-libs postgresql$v-contrib"

pgsql-core:          "postgresql$v postgresql$v-server postgresql$v-libs postgresql$v-contrib postgresql$v-plperl postgresql$v-plpython3 postgresql$v-pltcl postgresql$v-llvmjit"

pgsql-full:          "postgresql$v postgresql$v-server postgresql$v-libs postgresql$v-contrib postgresql$v-plperl postgresql$v-plpython3 postgresql$v-pltcl postgresql$v-llvmjit postgresql$v-test postgresql$v-devel"

pgsql-main:          "postgresql$v postgresql$v-server postgresql$v-libs postgresql$v-contrib postgresql$v-plperl postgresql$v-plpython3 postgresql$v-pltcl postgresql$v-llvmjit pg_repack_$v* wal2json_$v* pgvector_$v*"

pgsql-client:        "postgresql$v"

pgsql-server:        "postgresql$v-server postgresql$v-libs postgresql$v-contrib"

pgsql-devel:         "postgresql$v-devel"

pgsql-basic:         "pg_repack_$v* wal2json_$v* pgvector_$v*"

postgresql:          "postgresql$v*"

patroni:             "patroni patroni-etcd",

pgbouncer:           "pgbouncer",

pgbackrest:          "pgbackrest",

pgbackrest_exporter: "pgbackrest_exporter",

pg_exporter:         "pg_exporter",

vip-manager:         "vip-manager",

pgbadger:            "pgbadger",

pg_activity:         "pg_activity",

pg_filedump:         "pg_filedump",

pgxnclient:          "pgxnclient",

pgformatter:         "pgformatter",

pgcopydb:            "pgcopydb",

pgloader:            "pgloader",

pg_timetable:        "pg_timetable",

timescaledb-utils:   "timescaledb-tools timescaledb-event-streamer",

ivorysql:            "ivorysql4",

wiltondb:            "wiltondb",

polardb:             "PolarDB",

ferretdb:            "ferretdb2",

duckdb:              "duckdb",

etcd:                "etcd",

haproxy:             "haproxy",

pig:                 "pig",

vray:                "vray",

juicefs:             "juicefs",

restic:              "restic",

rclone:              "rclone",

```



**Install for another PG**



`pig` will use the default postgres installation in your active `PATH`,

but you can install extension for a specific installation with `-v` (when using the PGDG convention),

or passing any `pg_config` path for custom installation.



```bash

pig ext install pg_duckdb -v 16     # install the extension for pg16

pig ext install pg_duckdb -p /usr/lib/postgresql/17/bin/pg_config    # specify a pg17 pg_config  

```



**Install a specific Version**



You can also install PostgreSQL kernel packages with:



```bash

pig ext install pgvector=0.7.0 # install pgvector 0.7.0

pig ext install pg16=16.5      # install PostgreSQL 16 with a specific minor version

```



> Beware the **APT** repo may only have the latest minor version for its software (and require the full version string)



**Search Extension**



You can perform fuzzy search on extension name, description, and category.



```bash

$ pig ext ls olap



Name            State  Version  Cate  Flags   License       Repo     PGVer  Package               Description

----            -----  -------  ----  ------  -------       ------   -----  ------------          ---------------------

citus           added  13.0.2   OLAP  -dsl--  AGPL-3.0      PIGSTY   14-17  citus_17*             Distributed PostgreSQL as an extension

citus_columnar  added  13.0.2   OLAP  -ds---  AGPL-3.0      PIGSTY   14-17  citus_17*             Citus columnar storage engine

columnar        n/a    1.1.2    OLAP  -ds---  AGPL-3.0      PIGSTY   13-16  hydra_17*             Hydra Columnar extension

pg_analytics    added  0.3.7    OLAP  -ds-t-  PostgreSQL    PIGSTY   14-17  pg_analytics_17       Postgres for analytics, powered by DuckDB

pg_duckdb       added  0.3.1    OLAP  -dsl--  MIT           PIGSTY   14-17  pg_duckdb_17*         DuckDB Embedded in Postgres

pg_mooncake     added  0.1.2    OLAP  -d----  MIT           PIGSTY   14-17  pg_mooncake_17*       Columnstore Table in Postgres

duckdb_fdw      added  1.1.2    OLAP  -ds--r  MIT           PIGSTY   13-17  duckdb_fdw_17*        DuckDB Foreign Data Wrapper

pg_parquet      added  0.3.1    OLAP  -dslt-  PostgreSQL    PIGSTY   14-17  pg_parquet_17         copy data between Postgres and Parquet

pg_fkpart       added  1.7.0    OLAP  -d----  GPL-2.0       PIGSTY   13-17  pg_fkpart_17          Table partitioning by foreign key utility

pg_partman      added  5.2.4    OLAP  -ds---  PostgreSQL    PGDG     13-17  pg_partman_17*        Extension to manage partitioned tables by time or ID

plproxy         added  2.11.0   OLAP  -ds---  BSD 0-Clause  PIGSTY   13-17  plproxy_17*           Database partitioning implemented as procedural language

pg_strom        avail  5.2.2    OLAP  -ds--x  PostgreSQL    PGDG     13-17  pg_strom_17*          PG-Strom - big-data processing acceleration using GPU and NVME

tablefunc       added  1.0      OLAP  -ds-tx  PostgreSQL    CONTRIB  13-17  postgresql17-contrib  functions that manipulate whole tables, including crosstab



(13 Rows) (State: added|avail|n/a,Flags: b = HasBin, d = HasDDL, s = HasSolib, l = NeedLoad, t = Trusted, r = Relocatable, x = Unknown)

```



You can use the `-v 16` or `-p /path/to/pg_config` to find extension availability for other PostgreSQL installation.



**Print Extension Summary**



You can get extension metadata with `pig ext info` subcommand:



```bash

$ pig ext info pg_duckdb

╭────────────────────────────────────────────────────────────────────────────╮

│ pg_duckdb                                                                  │

├────────────────────────────────────────────────────────────────────────────┤

│ DuckDB Embedded in Postgres                                                │

├────────────────────────────────────────────────────────────────────────────┤

│ Extension : pg_duckdb                                                      │

│ Alias     : pg_duckdb                                                      │

│ Category  : OLAP                                                           │

│ Version   : 0.3.1                                                          │

│ License   : MIT                                                            │

│ Website   : https://github.com/duckdb/pg_duckdb                            │

│ Details   : https://pigsty.io/ext/olap/pg_duckdb                           │

├────────────────────────────────────────────────────────────────────────────┤

│ Extension Properties                                                       │

├────────────────────────────────────────────────────────────────────────────┤

│ PostgreSQL Ver │  Available on: 17, 16, 15, 14                             │

│ CREATE  :  Yes │  CREATE EXTENSION pg_duckdb;                              │

│ DYLOAD  :  Yes │  SET shared_preload_libraries = 'pg_duckdb'               │

│ TRUST   :  No  │  require database superuser to install                    │

│ Reloc   :  No  │  Schemas: []                                              │

│ Depend  :  No  │                                                           │

├────────────────────────────────────────────────────────────────────────────┤

│ RPM Package                                                                │

├────────────────────────────────────────────────────────────────────────────┤

│ Repository     │  PIGSTY                                                   │

│ Package        │  pg_duckdb_$v*                                            │

│ Version        │  0.3.1                                                    │

│ Availability   │  17, 16, 15, 14                                           │

├────────────────────────────────────────────────────────────────────────────┤

│ DEB Package                                                                │

├────────────────────────────────────────────────────────────────────────────┤

│ Repository     │  PIGSTY                                                   │

│ Package        │  postgresql-$v-pg-duckdb                                  │

│ Version        │  0.3.1                                                    │

│ Availability   │  17, 16, 15, 14                                           │

├────────────────────────────────────────────────────────────────────────────┤

│ Known Issues                                                               │

├────────────────────────────────────────────────────────────────────────────┤

│ el8                                                                        │

├────────────────────────────────────────────────────────────────────────────┤

│ Additional Comments                                                        │

├────────────────────────────────────────────────────────────────────────────┤

│ broken on el8 (libstdc++ too low), conflict with duckdb_fdw                │

╰────────────────────────────────────────────────────────────────────────────╯

```



**List Repo**



You can list all available repo / module (repo collection) with `pig repo list`:



```bash

$ pig repo list



os_environment: {code: el9, arch: amd64, type: rpm, major: 9}

repo_upstream:  # Available Repo: 32

  - { name: pigsty-local   ,description: 'Pigsty Local'       ,module: local    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'file:///www/pigsty' }

  - { name: pigsty-infra   ,description: 'Pigsty INFRA'       ,module: infra    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://repo.pigsty.io/yum/infra/$basearch' }

  - { name: pigsty-pgsql   ,description: 'Pigsty PGSQL'       ,module: pgsql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://repo.pigsty.io/yum/pgsql/el$releasever.$basearch' }

  - { name: nginx          ,description: 'Nginx Repo'         ,module: infra    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://nginx.org/packages/rhel/$releasever/$basearch/' }

  - { name: docker-ce      ,description: 'Docker CE'          ,module: infra    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.docker.com/linux/centos/$releasever/$basearch/stable' }

  - { name: baseos         ,description: 'EL 8+ BaseOS'       ,module: node     ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://dl.rockylinux.org/pub/rocky/$releasever/BaseOS/$basearch/os/' }

  - { name: appstream      ,description: 'EL 8+ AppStream'    ,module: node     ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://dl.rockylinux.org/pub/rocky/$releasever/AppStream/$basearch/os/' }

  - { name: extras         ,description: 'EL 8+ Extras'       ,module: node     ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://dl.rockylinux.org/pub/rocky/$releasever/extras/$basearch/os/' }

  - { name: crb            ,description: 'EL 9 CRB'           ,module: node     ,releases: [9]      ,arch: [x86_64, aarch64]  ,baseurl: 'https://dl.rockylinux.org/pub/rocky/$releasever/CRB/$basearch/os/' }

  - { name: epel           ,description: 'EL 8+ EPEL'         ,module: node     ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'http://download.fedoraproject.org/pub/epel/$releasever/Everything/$basearch/' }

  - { name: pgdg-common    ,description: 'PostgreSQL Common'  ,module: pgsql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/common/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg-el9fix    ,description: 'PostgreSQL EL9FIX'  ,module: pgsql    ,releases: [9]      ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/common/pgdg-rocky9-sysupdates/redhat/rhel-9-x86_64/' }

  - { name: pgdg13         ,description: 'PostgreSQL 13'      ,module: pgsql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/13/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg14         ,description: 'PostgreSQL 14'      ,module: pgsql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/14/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg15         ,description: 'PostgreSQL 15'      ,module: pgsql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/15/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg16         ,description: 'PostgreSQL 16'      ,module: pgsql    ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/16/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg17         ,description: 'PostgreSQL 17'      ,module: pgsql    ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/17/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg-extras    ,description: 'PostgreSQL Extra'   ,module: extra    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.postgresql.org/pub/repos/yum/common/pgdg-rhel$releasever-extras/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg13-nonfree ,description: 'PostgreSQL 13+'     ,module: extra    ,releases: [7,8,9]  ,arch: [x86_64]           ,baseurl: 'https://download.postgresql.org/pub/repos/yum/non-free/13/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg14-nonfree ,description: 'PostgreSQL 14+'     ,module: extra    ,releases: [7,8,9]  ,arch: [x86_64]           ,baseurl: 'https://download.postgresql.org/pub/repos/yum/non-free/14/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg15-nonfree ,description: 'PostgreSQL 15+'     ,module: extra    ,releases: [7,8,9]  ,arch: [x86_64]           ,baseurl: 'https://download.postgresql.org/pub/repos/yum/non-free/15/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg16-nonfree ,description: 'PostgreSQL 16+'     ,module: extra    ,releases: [8,9]    ,arch: [x86_64]           ,baseurl: 'https://download.postgresql.org/pub/repos/yum/non-free/16/redhat/rhel-$releasever-$basearch' }

  - { name: pgdg17-nonfree ,description: 'PostgreSQL 17+'     ,module: extra    ,releases: [8,9]    ,arch: [x86_64]           ,baseurl: 'https://download.postgresql.org/pub/repos/yum/non-free/17/redhat/rhel-$releasever-$basearch' }

  - { name: timescaledb    ,description: 'TimescaleDB'        ,module: extra    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://packagecloud.io/timescale/timescaledb/el/$releasever/$basearch' }

  - { name: wiltondb       ,description: 'WiltonDB'           ,module: mssql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://download.copr.fedorainfracloud.org/results/wiltondb/wiltondb/epel-$releasever-$basearch/' }

  - { name: ivorysql       ,description: 'IvorySQL'           ,module: ivory    ,releases: [7,8,9]  ,arch: [x86_64]           ,baseurl: 'https://repo.pigsty.io/yum/ivory/el$releasever.$basearch' }

  - { name: groonga        ,description: 'Groonga'            ,module: groonga  ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://packages.groonga.org/almalinux/$releasever/$basearch/' }

  - { name: mysql          ,description: 'MySQL'              ,module: mysql    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://repo.mysql.com/yum/mysql-8.0-community/el/$releasever/$basearch/' }

  - { name: mongo          ,description: 'MongoDB'            ,module: mongo    ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/8.0/$basearch/' }

  - { name: redis          ,description: 'Redis'              ,module: redis    ,releases: [8,9]    ,arch: [x86_64, aarch64]  ,baseurl: 'https://rpmfind.net/linux/remi/enterprise/$releasever/redis72/$basearch/' }

  - { name: grafana        ,description: 'Grafana'            ,module: grafana  ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://rpm.grafana.com' }

  - { name: kubernetes     ,description: 'Kubernetes'         ,module: kube     ,releases: [7,8,9]  ,arch: [x86_64, aarch64]  ,baseurl: 'https://pkgs.k8s.io/core:/stable:/v1.31/rpm/' }

repo_modules:   # Available Modules: 18

  - all       : pigsty-infra, pigsty-pgsql, pgdg-common, pgdg-el8fix, pgdg-el9fix, pgdg17, pgdg16, pgdg15, pgdg14, pgdg13, baseos, appstream, extras, powertools, crb, epel, base, updates, security, backports

  - pigsty    : pigsty-infra, pigsty-pgsql

  - pgdg      : pgdg-common, pgdg-el8fix, pgdg-el9fix, pgdg17, pgdg16, pgdg15, pgdg14, pgdg13

  - node      : baseos, appstream, extras, powertools, crb, epel, base, updates, security, backports

  - infra     : pigsty-infra, nginx, docker-ce

  - pgsql     : pigsty-pgsql, pgdg-common, pgdg-el8fix, pgdg-el9fix, pgdg13, pgdg14, pgdg15, pgdg16, pgdg17, pgdg

  - extra     : pgdg-extras, pgdg13-nonfree, pgdg14-nonfree, pgdg15-nonfree, pgdg16-nonfree, pgdg17-nonfree, timescaledb, citus

  - mssql     : wiltondb

  - mysql     : mysql

  - kube      : kubernetes

  - grafana   : grafana

  - pgml      : pgml

  - groonga   : groonga

  - haproxy   : haproxyd, haproxyu

  - ivory     : ivorysql

  - local     : pigsty-local

  - mongo     : mongo

  - redis     : redis

```



**Pigsty Management**



The **pig** can also be used as a [cli](https://pigsty.io/ext/pig/sty) tool for [Pigsty](https://pigsty.io) - the battery-include free PostgreSQL RDS.

Which brings HA, PITR, Monitoring, IaC, and all the extensions to your PostgreSQL cluster.



```bash

pig sty init     # install pigsty to ~/pigsty 

pig sty boot     # install ansible and other pre-deps 

pig sty conf     # auto-generate pigsty.yml config file

pig sty install  # run the install.yml playbook

```



You can use the `pig sty` subcommand to bootstrap pigsty on current node.



--------



## Compatibility



`pig` runs on: RHEL 8/9, Ubuntu 22.04/24.04, and Debian 12 and compatible OS



|  Code   | Distribution                   |  `x86_64`  | `aarch64`  |

|:-------:|--------------------------------|:----------:|:----------:|

| **el9** | RHEL 9 / Rocky9 / Alma9  / ... | PG 17 - 13 | PG 17 - 13 |

| **el8** | RHEL 8 / Rocky8 / Alma8 / ...  | PG 17 - 13 | PG 17 - 13 |

| **u24** | Ubuntu 24.04 (`noble`)         | PG 17 - 13 | PG 17 - 13 |

| **u22** | Ubuntu 22.04 (`jammy`)         | PG 17 - 13 | PG 17 - 13 |

| **d12** | Debian 12 (`bookworm`)         | PG 17 - 13 | PG 17 - 13 |



Here are some [bad cases](https://pigsty.io/ext/roadmap/badcase/) and limitation for above Linux distros:



- [`pg_duckdb`](https://pigsty.io/ext/olap/pg_duckdb) `el8:*:*`

- [`pljava`](https://pigsty.io/ext/lang/pljava): `el8:*:*`

- [`pllua`](https://pigsty.io/ext/lang/pllua): `el8:arm:13,14,15`

- [`h3`](https://pigsty.io/ext/gis/h3): `el8.amd.pg17`

- [`jdbc_fdw`](https://pigsty.io/ext/fdw/jdbc_fdw): `el:arm:*`

- [`pg_partman`](https://pigsty.io/ext/olap/pg_partman): `u24:*:13`

- [`wiltondb`](https://pigsty.io/ext/sim/babelfishpg_common): `d12:*:*`

- [`citus`](https://pigsty.io/ext/olap/citus) and [`hydra`](https://pigsty.io/ext/olap/hydra) are mutually exclusive

- [`pg_duckdb`](https://pigsty.io/ext/olap/pg_duckdb) will invalidate [`duckdb_fdw`](https://pigsty.io/ext/olap/duckdb_fdw)

- [`documentdb`](https://pigsty.io/ext/sim/documentdb) is not available on `arm` arch



--------



## About



[![Author: RuohangFeng](https://img.shields.io/badge/Author-Ruohang_Feng-steelblue?style=flat)](https://vonng.com/)

[![About: @Vonng](https://img.shields.io/badge/%40Vonng-steelblue?style=flat)](https://vonng.com/en/)

[![Mail: [email protected]](https://img.shields.io/badge/rh%40vonng.com-steelblue?style=flat)](mailto:[email protected])

[![Copyright: 2018-2025 [email protected]](https://img.shields.io/badge/Copyright-2025_(rh%40vonng.com)-red?logo=c&color=steelblue)](https://github.com/Vonng)

[![License: Apache](https://img.shields.io/badge/License-Apache--2.0-steelblue?style=flat&logo=opensourceinitiative&logoColor=green)](https://github.com/pgsty/pig/blob/main/LICENSE)



![pig](https://github.com/user-attachments/assets/17333d0d-a77a-4f6a-8fae-9e3f57fa798e)



[![pig-meme](https://github.com/user-attachments/assets/6d6e8740-0474-4f9e-8960-a141f90986b9)](https://medium.com/@fengruohang/the-idea-way-to-deliver-postgresql-extensions-35646464bb71)