Installing CloudNativePG™ using Rancher Console

CloudNativePG™ (CNPG) is certified SUSE Ready for the SUSE Rancher Kubernetes Engine starting with v1.28.0. EDB publishes and maintains the CNPG Helm chart in the SUSE Rancher Apps Catalog. You can deploy this chart directly from the Apps view in Rancher Manager.

Find CloudNativePG on the Charts page

  1. In the Rancher Console for your cluster, select Apps from the left-hand menu and then select Charts.

  2. Type "CloudNativePG" into the search bar at the top of the Charts page.

  3. Select the option for CloudNativePG (certified by EDB).

  4. Select the Install this version button.

Configure the installation parameters

  1. Select Create a new namespace from the Namespace drop-down, and enter cnpg-system for the namespace.

    Use your preferred naming scheme for this namespace; cnpg-system is used for examples here and in the CloudNativePG documentation.
  2. Select Next, and edit the values.yaml to customize installation. You can find a reference for the available values by selecting the View Chart Info button.

Install the operator

Select the Install button to run the installation with the values you've provided, creating the cnpg-system namespace for the operator. Rancher Console will display logs upon completion:

NAME: cloudnative-pg
LAST DEPLOYED: Mon Aug 17 20:14:53 2026
NAMESPACE: cnpg-system
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
CloudNativePG operator should be installed in namespace "cnpg-system".
You can now create a PostgreSQL cluster with 3 nodes as follows:
cat <

Verify the installation

  1. Select the button (or use the Ctrl+` key combination) to open the Kubectl shell.

  2. Enter kubectl -n cnpg-system get deploy

    You should see,

    NAME             READY   UP-TO-DATE   AVAILABLE   AGE
    cloudnative-pg   1/1     1            1           1m23s
  3. Enter kubectl -n cnpg-system rollout status deploy/cloudnative-pg

    You should see,

    deployment "cloudnative-pg" successfully rolled out

Next steps

Creating and managing PostgreSQL clusters

Refer to the CNPG documentation for details on creating and managing PostgreSQL clusters using the operator.

Maintenance

After installing a chart, you can view it by selecting Apps then Installed Apps in the left navigation menu. Select the menu option next to the cloudnative-pg entry in the list, and you'll see options for Edit/Change Version, Show Configuration, View YAML, Download YAML, and Delete.

Refer to Helm Charts and Apps in the SUSE Rancher Manager documentation for more information.


Could this page be better? Report a problem or suggest an addition!