Install Percona Operator for PostgreSQL with customized parameters¶

You can customize the configuration of Percona Distribution for PostgreSQL and install it with customized parameters.

To check available configuration options, see deploy/cr.yaml and Custom Resource Options.

kubectl Helm

To customize the configuration when installing with kubectl, do the following:

Clone the repository with all manifests and source code by executing the following command:
```
git clone -b v2.8.2 https://github.com/percona/percona-postgresql-operator
```
Edit the required options and apply your modified deploy/cr.yaml file as follows:
```
kubectl apply -f deploy/cr.yaml -n postgres-operator        
```

You can install the Operator deployment and the Percona Distribution for PostgreSQL cluster with custom parameters using Helm. Find what options you can customize in the Operator chart documentation and the Percona Distribution for PostgreSQL chart documentation .

You can provide custom parameters to Helm using either the --set flag or a values.yaml file. The --set flag is convenient for overriding a small number of parameters directly in the command line, while a values.yaml file is preferable when you want to manage many custom settings in one place. Both methods are fully supported by Helm and can be used as needed for your deployment.

Using --set flags

To pass a custom parameter to Helm, use the --set key=value flag with the helm install command.

For example, to enable Percona Monitoring and Management (PMM) for the database cluster, run:

helm install my-db percona/pg-db --version 2.8.2 --namespace my-namespace \
  --set postgresVersion=17.7-2 \
  --set pmm.enabled=true

Using a values.yaml file

Create a values.yaml file with your custom parameters and pass it to helm install with the -f or --values flag:

helm install my-db percona/pg-db --version 2.8.2 --namespace my-namespace -f values.yaml

Example values.yaml:

postgresVersion: 17.7-2
pmm:
  enabled: true

Naming conventions for Helm resources¶

When you install a chart, Helm creates a release and uses the release name and chart name to generate resource names. By default, resources are named release-name-chart-name.

You can override the default naming with the nameOverride or fullnameOverride options. Pass them using the --set flag or in your values.yaml file.

Option	Effect	Example
`nameOverride`	Replaces the chart name but keeps the release name in the generated name	`release-name-name-override`
`fullnameOverride`	Replaces the entire generated name with the specified value	`fullname-override`

Using nameOverride — replaces the chart name but keeps the release name:

helm install my-operator percona/pg-operator --namespace my-namespace \
  --set nameOverride=postgres-operator

Deployment name: my-operator-postgres-operator.

helm install cluster1 percona/pg-db -n my-namespace \
  --set nameOverride=postgres

Cluster name: cluster1-postgres.

Using fullnameOverride — replaces the full resource name:

helm install my-operator percona/pg-operator --namespace my-namespace \
  --set fullnameOverride=percona-postgresql-operator

Deployment name: percona-postgresql-operator.

helm install cluster1 percona/pg-db -n my-namespace \
  --set fullnameOverride=my-db

Cluster name: my-db.

Cluster name length

For the pg-db chart, the cluster name is limited to 21 characters, must consist of lowercase alphanumeric characters, ‘-’ or ‘.’, and must start and end with an alphanumeric character. Keep this in mind when using fullnameOverride or long release names.

Common Helm values reference¶

The following table lists commonly used values for the Operator and database charts. For the full list of options, see the chart values files.

Value	Charts	Description
`nameOverride`	pg-operator, pg-db	Replaces the chart name in generated resource names
`fullnameOverride`	pg-operator, pg-db	Replaces the entire generated resource name
`watchAllNamespaces`	pg-operator	Deploy the Operator in cluster-wide mode to watch all namespaces
`disableTelemetry`	pg-operator	Disable telemetry collection. See Telemetry for details

Last update: February 18, 2026
Created: February 18, 2026