install

Additional install commands

macOS

Homebrewverified · 100%

brew install kubectl-cnpg

local Homebrew formula metadata

Linux

Alpine Linux apkverified · 92%

sudo apk add kubectl-cnpg

Alpine Linux edge package indexes · kubectl-cnpg · source: dl-cdn.alpinelinux.org

Nixverified · 92%

nix profile install nixpkgs#kubectl-cnpg

nixpkgs package indexes · pkgs/by-name/ku/kubectl-cnpg/package.nix · source: api.github.com

openSUSE zypperverified · 92%

sudo zypper install kubectl-cnpg

openSUSE Tumbleweed package metadata · kubectl-cnpg · source: download.opensuse.org

overview

Package summary

CloudNativePG plugin for kubectl

Project links

Commands and aliases

kubectl-cnpg
kubectl_complete-cnpg

history

Project history and usage

kubectl-cnpg is the kubectl plugin shipped by the CloudNativePG project for managing PostgreSQL clusters on Kubernetes. The plugin is part of the main CloudNativePG repository rather than a separate utility repository.

Project history

The CloudNativePG GitHub repository was created on 2022-03-10. The project describes CloudNativePG as a platform for managing PostgreSQL databases in Kubernetes across the operational lifecycle, and its repository topics include `kubectl-plugin`, `operator`, `postgresql`, and high-availability concepts.

The kubectl plugin became one of the operator's user-facing control surfaces: the official plugin documentation covers installation scripts, Debian and RPM packages, AUR, Krew, Homebrew, supported architectures, completion, and command usage.

Adoption history

The plugin's adoption follows CloudNativePG adoption rather than an independent CLI culture. The package appears in Homebrew, APK, Nix, and zypper, and the official docs name Homebrew and Krew as supported install paths for workstation users.

The repository metadata observed on 2026-07-01 showed more than 8000 GitHub stars for CloudNativePG, which makes kubectl-cnpg a plugin attached to a prominent Kubernetes database operator rather than a tiny standalone addon.

How it is used

After installation, users run commands as `kubectl cnpg COMMAND [ARGS...]`. The official documentation emphasizes management tasks such as generating installation manifests and interacting with CloudNativePG-managed database clusters.

The plugin uses the normal kubectl configuration path through `~/.kube/config`, so it fits existing Kubernetes authentication and context workflows rather than defining a separate credentials store.

Why package nerds care

kubectl-cnpg is interesting as a packaged operator companion: the binary is distributed across OS package systems even though its value is tied to a cluster-side controller. It shows how serious Kubernetes operators often grow their own kubectl plugin for operational ergonomics.

Timeline

2022-03-10: CloudNativePG repository created.
2025-05-08: CloudNativePG release v1.29.1 published.
2026-06-29: CloudNativePG release v1.30.0 published, with plugin package examples in the documentation using v1.30.0 assets.

Related projects

Related projects include Kubernetes, kubectl, Krew, PostgreSQL, and the CloudNativePG operator. The package is not a general PostgreSQL client; it is an operational frontend for CloudNativePG resources.

Sources

security posture

Risk level: orange

infrastructure mutation or orchestration signal.

Risk classifier

orange risk · medium confidence · infrastructure

Why

infrastructure mutation or orchestration signal

Signals

text:cloud

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.kube/config

executables

Installed executables

Command	Kind	Exposure	Note
`kubectl-cnpg`	cli	global executable
`kubectl_complete-cnpg`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version1.30.0

manager updated2026-06-29

local dataok

upstreamnot checked

latest detectednot detected

https://github.com/cloudnative-pg/cloudnative-pg

infoNo cached GitHub release or tag data was available.https://github.com/cloudnative-pg/cloudnative-pgnone confidence

install metadata

Package metadata

Package key	brew:kubectl-cnpg
Version	1.30.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/kubectl-cnpg
Homepage	https://cloudnative-pg.io/
Repository	https://github.com/cloudnative-pg/cloudnative-pg
Upstream docs	https://cloudnative-pg.io/docs/devel/kubectl-plugin
License	Apache-2.0
Source archive	https://github.com/cloudnative-pg/cloudnative-pg.git
Last updated	2026-06-29T18:38:45Z
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	kubectl-cnpg
Version Scheme	0
Revision	0
Head Version	HEAD
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	head stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

kubectl-cnpg

nix profile install nixpkgs#kubectl-cnpg

normalized package name match
Matched by: Kubectl Cnpg

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ku/kubectl-cnpg/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

apk95%

kubectl-cnpg 1.29.0-r2

kubectl plugin for cloudnative-pg

https://github.com/cloudnative-pg/cloudnative-pg

sudo apk add kubectl-cnpg

License: Apache-2.0
Architecture: x86_64
Source Package: kubectl-cnpg
1 dependencies
1 provides
normalized package name match
Matched by: Kubectl Cnpg

Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: kubectl-cnpg from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

zypper95%

kubectl-cnpg 1.29.1-1.1

Manage PostgreSQL clusters built using CloudNativePG

https://github.com/cloudnative-pg/cloudnative-pg

sudo zypper install kubectl-cnpg

License: Apache-2.0
Category: Unspecified
Architecture: x86_64
Source Package: kubectl-cnpg
1 dependencies
1 provides
normalized package name match
Matched by: Kubectl Cnpg

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: kubectl-cnpg from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

zypper95%

kubectl-cnpg-bash-completion 1.29.1-1.1

Bash Completion for kubectl-cnpg

https://github.com/cloudnative-pg/cloudnative-pg

sudo zypper install kubectl-cnpg-bash-completion

License: Apache-2.0
Category: System/Shells
Architecture: noarch
Source Package: kubectl-cnpg
2 dependencies
1 provides
normalized package name match
Matched by: Kubectl Cnpg

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: kubectl-cnpg-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

zypper95%

kubectl-cnpg-fish-completion 1.29.1-1.1

Fish Completion for kubectl-cnpg

https://github.com/cloudnative-pg/cloudnative-pg

sudo zypper install kubectl-cnpg-fish-completion

License: Apache-2.0
Category: System/Shells
Architecture: noarch
Source Package: kubectl-cnpg
1 dependencies
1 provides
normalized package name match
Matched by: Kubectl Cnpg

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: kubectl-cnpg-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

zypper95%

kubectl-cnpg-zsh-completion 1.29.1-1.1

Zsh Completion for kubectl-cnpg

https://github.com/cloudnative-pg/cloudnative-pg

sudo zypper install kubectl-cnpg-zsh-completion

License: Apache-2.0
Category: System/Shells
Architecture: noarch
Source Package: kubectl-cnpg
1 dependencies
1 provides
normalized package name match
Matched by: Kubectl Cnpg

openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: kubectl-cnpg-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/kubectl-cnpg.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install kubectl-cnpg with Homebrew, apk, Nix, zypper

Additional install commands

macOS

Linux

Package summary

Project links

Commands and aliases

Project history and usage

Project history

Adoption history

How it is used

Why package nerds care

Timeline

Related projects

Sources

Risk level: orange

Risk classifier

Why

Signals

Install behavior

Recommended review

Configuration and credential file locations

Configuration files

Installed executables

Version and freshness

Package metadata

Source database details

Other package-manager records

Internal package links

Topical hubs

Related tools

Same workflow

Agent security guides

Generated from repository data

Combined YAML source

Used sources