Skip to content

Modules

This article lists available Pigsty modules and the current module planning.

Core and Extension Modules

The table lists modules with separate configuration and documentation. GA, BETA, and PILOT indicate maturity; the module count does not imply that every module is production-ready.

ModuleCategoryStatusDocumentationDescription
PGSQLCoreGA/docs/pgsqlHA PostgreSQL with backups, monitoring, SOPs, and extensions
INFRACoreGA/docs/infraLocal repository, VictoriaMetrics/Logs/Traces, Grafana, and other infrastructure
NODECoreGA/docs/nodeNode initialization/convergence: tuning, admins, HAProxy, Vector, Keepalived
ETCDCoreGA/docs/etcdPostgreSQL HA DCS: discovery, configuration, and election metadata
MINIOExtensionGA/docs/minioSilo S3-compatible object storage, usable as a PostgreSQL backup repository
REDISExtensionGA/docs/redisRedis (default) or Valkey standalone, sentinel, and cluster deployment/monitoring
DOCKERExtensionGA/docs/dockerDocker daemon and container application runtime
VAULTExtensionBETA/docs/vaultOpenBao KMS and secrets storage (roles/vault, roles/vault_remove)
JUICEExtensionBETA/docs/juiceJuiceFS distributed filesystem with PostgreSQL metadata
VIBEExtensionBETA/docs/vibeBrowser development environment with Code-Server, JupyterLab, Node.js, Claude Code, and Codex CLI
KAFKAExtensionPILOT/docs/kafkaApache Kafka 4.x dynamic KRaft cluster deployment, security baseline, and monitoring.
MYSQLExtensionPILOT/docs/mysqlNative MySQL 8.4 LTS standalone or three-node InnoDB Cluster with TLS, backups, and monitoring

Core Modules

Pigsty provides four core modules. Together, they deliver complete, highly available PostgreSQL services:

  • PGSQL: Self-healing PostgreSQL clusters with HA, PITR, IaC, SOP, monitoring, and 625 extensions.
  • INFRA: Local software repository, VictoriaMetrics, VictoriaLogs, VictoriaTraces, Grafana, Alertmanager, Blackbox Exporter…
  • NODE: Node convergence for hostname, timezone, NTP, SSH, sudo, HAProxy, Vector, and Keepalived.
  • ETCD: Distributed key-value store used as DCS for HA PostgreSQL clusters: consensus leader election/config management/service discovery.

These four modules are usually installed together. You can also use them separately. In practice, only the NODE module is usually mandatory.


Extension Modules

Pigsty provides eight optional extension modules to expand the data infrastructure:

  • MINIO: An S3-compatible object-storage module that deploys Silo and provides PostgreSQL backup integration and monitoring.
  • REDIS: Redis server with standalone/sentinel/cluster production deployment and full monitoring support.
  • DOCKER: Docker daemon service for one-click deployment of stateless software templates on Pigsty.
  • VAULT: secrets/KMS module (roles/vault + roles/vault_remove) based on OpenBao, with Raft, mandatory TLS 1.3, and auto-unseal, for transparent encryption, object storage, and application secrets.
  • JUICE: JuiceFS distributed filesystem module using PostgreSQL as metadata engine, providing shared POSIX storage.
  • VIBE: Browser-based development environment with Code-Server, JupyterLab, Node.js, Claude Code, and Codex CLI.
  • KAFKA: Apache Kafka 4.x dynamic KRaft clusters with TLS/SCRAM/ACL security baseline, declarative topics/users, and full monitoring.
  • MYSQL: native MySQL 8.4 LTS (roles/mysql + roles/mysql_remove), standalone or three-node single-primary InnoDB Cluster, with mandatory TLS, node VIP, XtraBackup physical backups, and monitoring/alerts.

Ecosystem Modules

These PostgreSQL ecosystem components are optional compatibility kernels or experimental capabilities and are not counted among the 12 modules above:

Was this page helpful?

Table reader