Install

Single-node quick install

On a Linux host, run:

# 1. Download & unpack the Pigsty source tarball
curl -fsSL https://repo.pigsty.cc/get | bash -s v4.2.2

cd ~/pigsty

# 2. Install Ansible and its dependencies
./bootstrap

# 3. Generate pigsty.yml with sensible defaults
./configure

# 4. Run the installation playbook
./install.yml

After 5–10 minutes Pigsty is up. Default endpoints:

• PostgreSQL 17 on port 5432
• Grafana UI at http://<IP>:3000 (default admin / pigsty)
• Prometheus at http://<IP>:9090
• MinIO console at http://<IP>:9001

Common install modes

Mode	Best for	Read more
Standard	Single-node / sandbox / small prod	Single-node install
Offline	Air-gapped environments, domestic OS	Offline mode
Slim	Just PostgreSQL, no monitoring stack	Slim mode
Multi-node	Production HA	Advanced → Deployment

Provisioning hosts via Vagrant / Terraform

Pigsty ships ready-to-use infrastructure templates:

• Vagrant sandbox — multi-node VMs locally with one command
• Terraform templates — provision on AWS / Alibaba Cloud / etc.

Verify

# Check services
systemctl status patroni pgbouncer

# Connect via local Unix socket
psql -h /var/run/postgresql -U dbuser_dba postgres -c '\l'

# Or over TCP
psql "postgres://dbuser_dba@127.0.0.1/postgres"

Next

Once installed, continue to Configure to create your first business user and database.