pig repo
The pig repo command is a comprehensive package repository manager. It can add, remove, create, and manage repositories on RPM systems (RHEL/CentOS/Rocky/Alma) and Debian systems (Debian/Ubuntu).
pig repo - Manage Linux APT/YUM Repo
pig repo list # available repo list (info)
pig repo info [repo|module...] # show repo info (info)
pig repo status # show current repo status (info)
pig repo add [repo|module...] # add repo and modules (root)
pig repo rm [repo|module...] # remove repo & modules (root)
pig repo update # update repo pkg cache (root)
pig repo create # create repo on current system (root)
pig repo boot # boot repo from offline package (root)
pig repo cache # cache repo as offline package (root)
Examples:
pig repo add -ru # add all repo and update cache (brute but effective)
pig repo add pigsty -u # gentle version, only add pigsty repo and update cache
pig repo add node pgdg pigsty # essential repo to install postgres packages
pig repo add all # all = node + pgdg + pigsty
pig repo add all extra # extra module has non-free and some 3rd repo for certain extensions
pig repo update # update repo cache
pig repo create # update local repo /www/pigsty meta
pig repo boot # extract /tmp/pkg.tgz to /www/pigsty
pig repo cache # cache /www/pigsty into /tmp/pkg.tgz
| Command | Description | Notes |
|---|---|---|
repo list | Print available repositories and modules | |
repo info | Show repository details | |
repo status | Show current repository status | |
repo add | Add repositories | Requires sudo or root |
repo set | Clear, overwrite, and update repositories | Requires sudo or root |
repo rm | Remove repositories | Requires sudo or root |
repo update | Update repository cache | Requires sudo or root |
repo create | Create local YUM/APT repository | Requires sudo or root |
repo cache | Create offline package from local repo | Requires sudo or root |
repo boot | Bootstrap repository from offline package | Requires sudo or root |
repo reload | Refresh repository catalog |
Quick Start
# Method 1: clean existing repositories, add all required repos, and update cache (recommended)
pig repo add all --remove --update # remove old repos, add all required repos, update cache
# Method 1 variant: one step
pig repo set # = pig repo add all --remove --update
# Method 2: gentle mode - only add required repos and keep current repo configuration
pig repo add pgsql # add PGDG and Pigsty PGSQL repositories
pig repo add pigsty --region=china # add Pigsty repositories with China region
pig repo add pgdg --region=europe # add PGDG repositories with Europe region
pig repo add infra --region=default # add INFRA repositories with default region
# If the commands above did not use -u|--update, run this as an extra step
pig repo update # update system package cache
Modules
In pig, APT/YUM repositories are organized as modules: groups of repositories serving a specific purpose.
| Module | Description | Repository List |
|---|---|---|
all | All core modules required to install PG | node + infra + pgsql |
pgsql | PGDG + Pigsty PG extensions | pigsty-pgsql + pgdg |
pigsty | Pigsty Infra + PGSQL repositories | pigsty-infra, pigsty-pgsql |
pgdg | PGDG official repositories | pgdg-common, pgdg14-18 |
node | Linux system repositories | base, updates, extras, epel, baseos, appstream… |
infra | Infrastructure component repositories | pigsty-infra, nginx, docker-ce |
docker | Docker repository | docker-ce |
beta | PostgreSQL 19 beta repositories | pgdg19-beta, pgdg-beta |
extra | PGDG non-free and third-party extensions | pgdg-extras, timescaledb, citus |
groonga | PGroonga repository | groonga |
mssql | WiltonDB repository (deprecated) | babelfish |
percona | Percona PG + PG_TDE | percona |
llvm | LLVM toolchain repository | llvm |
kube | Kubernetes repository | kubernetes |
grafana | Grafana repository | grafana |
haproxy | HAProxy repositories | haproxyd, haproxyu |
redis | Redis repository | redis |
mongo | MongoDB repository | mongo |
mysql | MySQL repository | mysql |
click | ClickHouse repository | clickhouse |
gitlab | GitLab repository | gitlab-ce, gitlab-ee |
Pig also includes APT/DNF repositories for other databases and systems such as redis, kubernetes, grafana, clickhouse, gitlab, haproxy, mongodb, and mysql.
In general, node (Linux system repositories) and pgsql (PGDG + Pigsty) are required for PostgreSQL installation. The infra repository is optional and contains tools, IvorySQL kernel packages, and similar components. The special all module adds all required repositories at once and is a suitable starting point for most users.
pig repo add all # add node, pgsql, and infra repositories
pig repo add # default to the all module when no argument is given
pig repo set # set clears/backups existing definitions and overwrites with new repo definitions
Repository Definitions
The full repository definition bundled with Pigsty is in cli/repo/assets/repo.yml.
You can create ~/.pig/repo.yml to explicitly modify and override pig’s repository definitions. When editing repository definitions, you can add extra regional mirror URLs under baseurl, such as China or Europe mirrors. When --region is specified, pig first looks for the matching regional URL and falls back to the default URL if the region is unavailable.
repo list
pig repo list lists all repository modules available on the current system.
pig repo list # list repositories available on current system
pig repo list all # list all repositories without filtering
repo info
Show detailed information for specific repositories or modules, including URLs, metadata, regional mirrors, and .repo / .list repository file content.
pig repo info pgdg # show pgdg module information
pig repo info pigsty pgdg # show multiple modules
pig repo info all # show all modules
repo status
Show current repository configuration on the system.
pig repo status
repo add
Add repository configuration files to the system. Requires root/sudo privileges.
pig repo add pgdg # add PGDG repository
pig repo add pgdg pigsty # add multiple repositories
pig repo add all # add all required repositories (pgdg + pigsty + node)
pig repo add pigsty -u # add and update cache
pig repo add all -r # remove existing repos before adding
pig repo add all -ru # remove, add, and update (full reset)
pig repo add pgdg --region=china # use China mirror
Options:
-r|--remove: remove existing repositories before adding new ones-u|--update: run package cache update after adding repositories--region <region>: use regional mirror repositories (default/china/europe)
| Platform | Module Location |
|---|---|
| EL | /etc/yum.repos.d/<module>.repo |
| Debian | /etc/apt/sources.list.d/<module>.list |
repo set
Equivalent to repo add --remove --update. It clears existing repositories, sets up new ones, then updates cache.
pig repo set # replace with default repositories
pig repo set pgdg pigsty # replace with selected repositories and update
pig repo set all --region=china # use China mirror
repo rm
Remove repository configuration files and back them up.
pig repo rm # remove all repositories
pig repo rm pgdg # remove selected repository
pig repo rm pgdg pigsty -u # remove and update cache
| Platform | Backup Location |
|---|---|
| EL | /etc/yum.repos.d/backup/ |
| Debian | /etc/apt/sources.list.d/backup/ |
repo update
Update package-manager cache to reflect repository changes.
pig repo update # update package cache
| Platform | Equivalent Command |
|---|---|
| EL | dnf makecache |
| Debian | apt update |
repo create
Create a local package repository for offline installation.
pig repo create # create at default location (/www/pigsty)
pig repo create /srv/repo # create at custom location
| Platform | Dependency |
|---|---|
| EL | createrepo_c |
| Debian | dpkg-dev |
repo cache
Create a compressed tarball of repository contents for offline distribution.
pig repo cache # default: /www to /tmp/pkg.tgz
pig repo cache -d /srv # custom source directory
Options:
-d, --dir: source directory, default/www/-p, --path: output path, default/tmp/pkg.tgz
repo boot
Extract and set up a local repository from an offline package.
pig repo boot # default: /tmp/pkg.tgz to /www
pig repo boot -p /mnt/pkg.tgz # custom package path
pig repo boot -d /srv # custom target directory
Options:
-p, --path: package path, default/tmp/pkg.tgz-d, --dir: target directory, default/www/
repo reload
Refresh repository metadata from GitHub to the latest version.
pig repo reload # refresh repository catalog
The updated file is placed in ~/.pig/repo.yml.
Feedback
Was this page helpful?
Thanks for the feedback! Please let us know how we can improve.
Sorry to hear that. Please let us know how we can improve.