Pigsty Docker

Run Pigsty in Docker containers with full systemd support.

Works on both macOS (Docker Desktop) and Linux.

Docker Hub: https://hub.docker.com/r/pgsty/pigsty
Documentation: https://pigsty.io/docs/docker
GitHub: https://github.com/pgsty/pigsty

Quick Start

Make sure the default host ports (2222/8080/8443/5432) are available. otherwise, edit the .env first. Then run the following commands to launch Pigsty in Docker:

cd ~/pigsty/docker    # enter this dir 
make launch           # = make up config deploy

You can also build the base container image first (based on debian13):

cd ~/pigsty/docker
make build launch     # build image rather than pull

Image

Image	Pull	Size	Contents
`pgsty/pigsty`	~500MB	1.3GB	Debian 13 + systemd + SSH + pig + Ansible

Supports amd64 (x86_64) and arm64 (Apple Silicon, AWS Graviton)
Tags match pigsty version: v4.0.0, latest
Configuration pre-generated with docker template
Ready to deploy with ./deploy.yml

Web Portal & PostgreSQL are available after Deployment (./deploy.yml)

Configuration

Configure ports via environment variables or .env file:

Variable	Default	Container	Description
`PIGSTY_VERSION`	v4.0.0	-	Image tag
`PIGSTY_SSH_PORT`	2222	22	SSH access
`PIGSTY_HTTP_PORT`	8080	80	Nginx HTTP
`PIGSTY_HTTPS_PORT`	8443	443	Nginx HTTPS
`PIGSTY_PG_PORT`	5432	5432	PostgreSQL

Accessing Services

Service	URL / Command	Credentials
SSH	`ssh root@localhost -p 2222`	`pigsty`
Web Portal	http://localhost:8080	-
Grafana	http://localhost:8080/ui	`admin` / `pigsty`
PostgreSQL	`psql postgres://dbuser_dba:DBUser.DBA@localhost:5432/postgres`	`DBUser.DBA`

Web Portal & PostgreSQL are available after Deployment (./deploy.yml)

Commands Reference

Docker Compose (Recommended)

make up           # Start container
make down         # Stop and remove
make exec         # Enter container
make config       # Run ./configure (optional)
make deploy       # Run ./deploy.yml
make launch       # up + deploy

Build Image

make build        # Build image locally
make buildnc      # Build without cache
make push         # Build and push multi-arch image

Alternative (docker run)

make run          # Run with docker run
make clean        # Stop and remove
make purge        # Remove + delete data

Container Access

make exec         # Bash into container
make ssh          # SSH into container
make log          # View logs
make status       # systemd status
make ps           # Process list

Manual Run

If you prefer docker run over docker compose:

mkdir -p ./data
docker run -d --privileged --name pigsty \
  -p 2222:22 -p 8080:80 -p 5432:5432 \
  -v ./data:/data \
  pgsty/pigsty:v4.0.0

docker exec -it pigsty ./configure -c docker -g --ip 127.0.0.1
docker exec -it pigsty ./deploy.yml

Requirements

Docker 20.10+ (Docker Engine on Linux / Docker Desktop on macOS)
At least 1 vCPU / 2GB+ RAM
20GB+ disk space

3.7 KiB Raw Permalink Blame History