Registry: Container Image Cache

Pigsty v4.2 provides the app/registry template (conf/app/registry.yml) for:

• Docker Registry cache service (default 5000)
• Optional management UI (default 5080)

Quick Start

curl -fsSL https://repo.pigsty.io/get | bash; cd ~/pigsty
./bootstrap
./configure -c app/registry
vi pigsty.yml                 # update domains, certs, and ports if needed
./deploy.yml
./docker.yml
./app.yml

Default endpoints:

• Registry API: http://<IP>:5000 or http://d.pigsty
• Registry UI: http://<IP>:5080 or http://dui.pigsty

Image data is stored in /data/registry by default.

Docker Client Configuration

If you run HTTP without TLS, Docker must trust the registry explicitly:

{
  "registry-mirrors": ["http://d.pigsty"],
  "insecure-registries": ["d.pigsty:5000"]
}

After editing /etc/docker/daemon.json, restart Docker:

systemctl restart docker

Operations

app/registry/Makefile runs in /opt/registry by default:

cd /opt/registry
make up
make status
make health
make log

References

• Docker Registry docs: https://docs.docker.com/registry/
• Pigsty template: https://github.com/pgsty/pigsty/blob/main/conf/app/registry.yml