Skip to content

docker

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

docker

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
.env
.env
 
 
Dockerfile
Dockerfile
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
docker-compose.yml
docker-compose.yml
 
 

README.md

Pigsty Docker

Run Pigsty in Docker containers with full systemd support.

Works on both macOS (Docker Desktop) and Linux.

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.3.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.3.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.3.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