\n\n# CloudNativePG Helm Chart\n\nCloudNativePG is a Kubernetes operator that manages the full lifecycle of highly available PostgreSQL database clusters with a primary/standby architecture. The CloudNativePG Helm chart automates deployment and configuration of CloudNativePG in Kubernetes clusters using Minimus images.\n\n\n## {{icon-list-search}} Prerequisites\n\n- A subscription to the Minimus images included in the chart\n- A running Kubernetes cluster (v1.21 or higher is recommended)\n- `kubectl` installed and configured\n- Helm v3.8 or higher for OCI support ([Installation instructions](https://helm.sh/docs/intro/install/))\n- Cluster Admin privileges\n\n**Note**: This chart installs the CloudNativePG Custom Resource Definitions (`clusters.postgresql.cnpg.io`, `backups.postgresql.cnpg.io`, and related CRDs) by default. Installing CRDs requires cluster-wide privileges.\n\n

\n\n---\n\n

\n\n## {{icon-rocket}}Try It Out\n\nIn this example we will deploy CloudNativePG on a Kubernetes cluster using the Minimus CloudNativePG Helm chart. Once the operator is running you can declare PostgreSQL clusters as Kubernetes resources and the operator manages provisioning, failover, and backups for you.\n\n

\n\n### Step 1: Start Cluster\n\n

\n\nIf you have a cluster to work with, skip this step. Otherwise, start a Minikube cluster. [Deployment instructions](https://minikube.sigs.k8s.io/docs/start/?arch=%2Flinux%2Fx86-64%2Fstable%2Fbinary+download)\n\n

\n\n### Step 2: Create Namespace\n\n

\n\nCreate a namespace:\n\n```\nkubectl create ns cloudnative-pg\n```\n\n{{if-enterprise}}\n\nNext, create a Kubernetes secret for the Minimus token:\n\n```\nkubectl create secret docker-registry minimus-registry \\\n --docker-server=reg.mini.dev \\\n --docker-username=minimus \\\n --docker-password={{pull-token}} \\\n --namespace=cloudnative-pg\n```\n\n{{/if-enterprise}}\n\n

\n\n### Step 3: Deploy the Helm Chart\n\n

\n\nDeploy the Minimus Helm chart:\n\n```\nhelm install my-cloudnative-pg {{oci-url}} \\\n --version {{chart-version}} \\\n -n cloudnative-pg \\\n --wait\n```\n\nIf you want to override the chart's defaults, go to the Values tab, save a copy locally with your changes. Deploy the chart with your overrides using `-f values.yaml`:\n\n```\nhelm install my-cloudnative-pg {{oci-url}} \\\n --version {{chart-version}} \\\n -f values.yaml \\\n -n cloudnative-pg \\\n --wait\n```\n\n

\n\n### Step 4: Verify CloudNativePG is Running\n\n

\n\nCheck that the operator pod is running:\n\n```\nkubectl get pods -n cloudnative-pg\n```\n\nYou should see the operator pod in the `Running` state:\n\n```\nNAME READY STATUS RESTARTS AGE\nmy-cloudnative-pg-xxxxxxxxx-xxxxx 1/1 Running 0 60s\n```\n\n

\n\n### Step 5: Test the Operator\n\n

\n\nConfirm the operator registered its Custom Resource Definitions:\n\n```\nkubectl get crd | grep cnpg.io\n```\n\nCreate a minimal PostgreSQL `Cluster` and let the operator provision it:\n\n```\nkubectl apply -n cloudnative-pg -f - <\n\n### Step 6: Clean Up\n\n\n\nUninstall the chart and delete the namespace to remove all resources:\n\n```\nhelm uninstall my-cloudnative-pg -n cloudnative-pg\nkubectl delete namespace cloudnative-pg\n```\n\n

\n\n---\n\n

\n\n## {{icon-info-circle}}Terms & Info\n\n

\n\n### Trademark\n\n

\n\nThis catalog is published by Minimus. All product names, logos, and marks, other than those belonging to Minimus, shown are owned by their respective rights holders and appear here only to identify the open source software each image contains. Minimus claims no ownership of those marks and implies no affiliation with, endorsement by, certification by, or sponsorship by any rights holder.\n\n\n{{if-anonymous}} \n\n

\n\n### Disclaimer\n\n

\n\n\nImages are provided \"as-is\" without warranty of any kind. \"Hardened\" refers to the security configuration applied at the time of build and does not constitute a guarantee of ongoing security or absence of vulnerabilities. The free tier is provided without support, SLA, or guaranteed patching timelines. Security updates may be applied to paid subscriptions before or instead of free tier images. By pulling or using any image you agree to our [Terms of Use](https://www.minimus.io/terms-of-use).\n\n{{/if-anonymous}}\n\n\n

\n","ociDigest","sha256:86e7118a826a9dcfe201ec050013635c0035c6d184bb48bcf2c02708389cda04","tarballDigest","sha256:0930dd0eb045b2e7e6c1d718664ccabb013a54c7bed9a0a0c36e7785b8166ad1","infra",[408],"thirdPartyImageName","ghcr.io/cloudnative-pg/cloudnative-pg","2026-06-10T15:08:59.196959Z","2026-08-01T15:00:19.415215Z","private","isCustom","groups",[377],"shortDescription","","published","family","edition","vanilla","fips","thirdPartyVulnsCount",17,"webappURL","https://images.minimus.io","docsURL","https://docs.minimus.io/","docsMap",{"_118":439,"_440":441,"_442":419,"_443":444,"_445":446,"_447":448,"_449":450,"_451":452,"_453":419,"_454":419,"_455":419,"_456":457,"_458":459,"_460":461,"_462":463,"_464":465,"_466":419,"_467":468,"_469":419,"_470":419,"_471":419,"_472":419,"_473":419,"_474":419,"_475":419,"_476":419,"_477":419,"_478":419,"_479":480,"_481":482,"_483":484,"_485":486,"_487":488,"_489":490,"_491":419,"_492":419,"_493":419,"_494":419,"_495":496,"_497":419,"_498":499,"_500":501,"_502":503,"_504":503,"_505":506,"_507":419,"_508":419,"_509":510,"_511":512,"_513":514,"_515":516,"_517":518},"user","isAnonymous","isTokensExpired","license","cookiebotCBID","40e95942-a9eb-491e-8406-2f08417ec73b","https://docs.minimus.io","/actions","https://docs.minimus.io/remediate/actions","/actions/?","/actions/create","https://docs.minimus.io/remediate/create-action","/advisories","https://docs.minimus.io/remediate/advisories","/advisories/?","https://docs.minimus.io/remediate/cve-advisory","/advisories/?/exploitability","https://docs.minimus.io/remediate/threat-intel#threat-intel","/advisories/?/packages","https://docs.minimus.io/remediate/cve-advisory#status-history","/advisories/?/packages/?","/advisories/?/references","/advisories/?/severity","/charts","https://docs.minimus.io/foundations/helm-charts","/creator/list","https://docs.minimus.io/enterprise-edition/image-creator","/creator/files","https://docs.minimus.io/enterprise-edition/file-bundles","/supply-chain-protection","https://docs.minimus.io/enterprise-edition/supply-chain","/images","https://docs.minimus.io/gallery","/images/?","/images/?/changelog","https://docs.minimus.io/foundations/image-card#changelog","/images/?/changelog/?","/images/?/changelog/?/versions/?/?","/images/?/changelog/?/versions/?/?/exploitability","/images/?/changelog/?/versions/?/?/packages","/images/?/changelog/?/versions/?/?/packages/?","/images/?/changelog/?/versions/?/?/references","/images/?/changelog/?/versions/?/?/severity","/images/?/changelog/?/versions/?/digest-history","/images/?/lines","/images/?/lines/?","/images/?/lines/?/versions/?","https://docs.minimus.io/foundations/image-version","/images/?/lines/?/versions/?/digest-history","https://docs.minimus.io/foundations/image-version#digest-history","/images/?/lines/?/versions/?/sbom","https://docs.minimus.io/foundations/image-version#sbom","/images/?/lines/?/versions/?/specification","https://docs.minimus.io/foundations/image-version#specification","/images/?/lines/?/versions/?/vulnerabilities","https://docs.minimus.io/foundations/image-version#vulnerabilities","/images/?/risk-reduction","https://docs.minimus.io/foundations/image-card#risk-reduction","/images/?/risk-reduction/?","/images/?/risk-reduction/?/exploitability","/images/?/risk-reduction/?/references","/images/?/risk-reduction/?/severity","/images/?/compliance/cis","https://docs.minimus.io/foundations/image-card#compliance","/manage","/manage/self-hosting","https://docs.minimus.io/manage/self-hosted-registry","/manage/subscription","https://docs.minimus.io/introduction/subscription","/manage/logs/activity-log","https://docs.minimus.io/manage/activity-log","/manage/logs/audit-log","/manage/tokens","https://docs.minimus.io/manage/token","/manage/tokens/create","/manage/tokens/delete/?","/manage/access/users","https://docs.minimus.io/manage/users","/manage/access/users/create","https://docs.minimus.io/manage/users#add-users","/manage/access/users/saml","https://docs.minimus.io/sso/saml","/manage/access/groups","https://docs.minimus.io/manage/user-groups","/manage/minicli","https://docs.minimus.io/enterprise-edition/minicli","toast","gtmID","GTM-56RQNQ3D","hubspotID","42541238"]