Define environment variables

You can configure environment variables in Percona Operator for PostgreSQL for the following purposes:

1. Operator environment variables – To control the Operator’s behavior, such as logging, telemetry, and which namespaces it watches. You set these in the Operator Deployment (for example in deploy/bundle.yaml or via the Helm chart values).
2. Cluster component environment variables – To customize the behavior of cluster components (PostgreSQL, pgBackRest, pgBouncer). You define these in your cluster Custom Resource and, when needed, store sensitive values in Kubernetes Secrets.

When to use environment variables

Type	Use cases
Operator environment variables	* Control logging for debugging and log aggregation * Manage telemetry * Configure which namespaces the Operator watches (single-namespace vs cluster-wide) * Set the number of concurrent reconciliation workers for multi-cluster environments * Enable feature gates such as auto-growable volumes
Cluster component environment variables	* Customize PostgreSQL, pgBackRest, or pgBouncer behavior * Pass configuration or secrets into Pods * Integrate with external systems or monitoring.

---

Last update: February 13, 2026
Created: February 13, 2026