PostgreSQL

Production-ready PostgreSQL deployment with support for standalone and streaming replication architectures.

Key Features

Standalone and replication — Single instance or primary with streaming replicas
Automatic initialization — Init scripts, extensions, and custom configuration
Backup support — Configurable backup strategies
Metrics — Prometheus exporter with ServiceMonitor
Security — Non-root containers, network policies, TLS support
Persistent storage — Configurable PVCs with storage class selection

Installation

HTTPS repository:

helm repo add helmforge https://repo.helmforge.dev
helm repo update
helm install my-pg helmforge/postgresql

OCI registry:

helm install my-pg oci://ghcr.io/helmforgedev/helm/postgresql

Standalone Example

# values.yaml
architecture: standalone

auth:
  postgresPassword: "my-secret-password"
  database: myapp
  username: myuser
  password: "user-password"

primary:
  persistence:
    size: 20Gi

metrics:
  enabled: true
  serviceMonitor:
    enabled: true

Replication Example

architecture: replication

auth:
  postgresPassword: "my-secret-password"
  database: myapp
  username: myuser
  password: "user-password"
  replicationPassword: "repl-password"

primary:
  persistence:
    size: 20Gi

readReplicas:
  replicaCount: 2
  persistence:
    size: 20Gi

Key Values

Key	Default	Description
`architecture`	`standalone`	`standalone` or `replication`
`auth.postgresPassword`	`""`	PostgreSQL superuser password
`auth.database`	`""`	Default database to create
`auth.username`	`""`	Default user to create
`primary.persistence.size`	`8Gi`	Primary PVC size
`readReplicas.replicaCount`	`1`	Number of read replicas
`metrics.enabled`	`false`	Enable Prometheus exporter

More Information

See the source code and full values reference on GitHub.