Skip to content
Browse Configs

Deep Dives

AI: Claude and Codex patterns

ConfigHub: Deploy and manage

Configs
Stacks
Apps
Plugins
Guides
Docs

external-secrets/external-secrets

Runs on your laptop

Choose a tested starting configuration for external-secrets/external-secrets@2.5.0. Read its exact Kubernetes objects, required setup, and current evidence before you deploy it.

Start with default. The page also shows other recorded choices. The page does not claim every possible values combination.

Evidence labels: Pass has a linked result. Watch names a limit to check. Blocked means do not use that path yet.

Upstream: the Catalog fetched chart external-secrets from the Helm repository https://charts.external-secrets.io at version 2.5.0. find this chart on Artifact Hub · Helm documentation. This page adds checked configurations and test results.

Catalog readiness: Ready to try.

Licenses: chart Apache-2.0 (the chart source repository's LICENSE, read 2026-08-08). This describes the chart templates, not the packaged application images.

Check this chart and version Try the package Plan an upgrade or promotion

Already reviewed the result? Keep it in ConfigHub when you need history, variants, approvals, or delivery.

Use this entry in ConfigHub in five steps, from fetching its exact objects to promoting a change.

What it is. external-secrets/external-secrets 2.5.0, as 42 Kubernetes objects in its default preset. The Catalog holds 2 presets of this version.

Install it. curl -fsSL -o try-objects.sh https://confighub.github.io/helm-expt/site/sh/external-secrets-external-secrets-2-5-0/default/try-objects.sh && bash try-objects.sh

OCI bundle. oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/bundles/catalog-external-secrets-external-secrets-2-5-0-default:latest@sha256:d85f2a5e9b8a71e3b67e2e9ad5d4d9b8a377fa4aefe367d3b5f643b524b43161

Needs first. Secret external-secrets/external-secrets-webhook must exist before apply. Rendered webhook Secret separated by installer and populated by the cert-controller after apply.

How it works. How the model works, and Helm in the Catalog.

What this page gives you

Every chart page follows the same order. Choose a configuration, inspect its objects and setup work, then read the tests that have run. Open the worked examples.

Most choices are made before you install

The package fixes and checks almost everything at build time. What you set is small and typed.

You can read the test results

Open the saved results for the Helm comparison, live install, and delivery checks.

See hooks, CRDs, and setup work

The page names the work and says which delivery path has actually run.

What To Use

default configuration: 42 rendered objects · 1 image · 1 target prerequisite · 0 hook or setup steps · 6/7 checks passing. These counts come from the linked test records.

defaultRecommended first base variant
2Supported base variants
Recommended first pathFirst-configuration status
Ready for a target-specific production reviewProduction status

Use the public catalog entry, then check the exact configuration and its tests before making a production claim.

QuestionAnswer
Catalog readinessReady to try
Chart version2.5.0
Exact installer packageoci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001
OCI publication statuspublication receipt recorded
Publisher signaturepublisher signature recorded and verified
Latest upstream seen2.5.0
Supported base variantsdefault;no-crds
Not yet availableNo specific missing capability is recorded. The first configuration still needs review.
Namespaceexternal-secrets

Four Separate Questions

Inspecting a source, producing objects, checking a destination, and checking a live result are different jobs. A Catalog match is useful for comparison but is not required. A missing destination or deployment is shown as not run or blocked, not as a failed configuration.

QuestionCurrent answerWhat it needsStatus
What do I have?Inspect the helm source, choices, locks, and any existing output before selecting a destination.Destination access: no
Selected configuration deployed: no
Available to inspect
evidence recorded
What will it produce?Run the recorded Helm render step to produce the exact Kubernetes objects for this configuration.Destination access: no
Selected configuration deployed: no
Checked: passed
evidence recorded
Can this destination accept it?The destination has not been checked for this exact configuration. A recorded source or render result is not a destination pass.Destination access: yes
Selected configuration deployed: no
Not run
no run recorded
Did it work?No post-deployment result is recorded for this exact configuration. Publication, upload, or rendering is not proof that it ran correctly.Destination access: yes
Selected configuration deployed: yes
Not run
no run recorded

Open the complete assessment, source, lifecycle, and evidence record.

Where This Chart's Settings Come From

Base variantHelm valuesConfigHub changesInstall work
defaulteffective-values.yamlNone in the catalog base. Later edits appear in ConfigHub Unit revision history or a derived variant.1 prerequisite recorded.
no-crdseffective-values-no-crds.yamlNone in the catalog base. Later edits appear in ConfigHub Unit revision history or a derived variant.24 prerequisites recorded.

Upgrade rule: if a new Helm render and a ConfigHub revision both change the same field, review the overlap before promotion. The values profile shows the Helm side; Unit revision history shows the ConfigHub side.

Read the full values-versus-ConfigHub rule. For the staging commands behind each prerequisite, open the prerequisite action packets.

What This Chart Contains

Shipping a chart as plain rendered YAML is faster and simpler, and it silently drops anything Helm was going to do afterwards. This section reports what a scan of the packaged chart found, across 56 files.

ConstructFoundWhy it matters when a chart ships as plain YAML
Webhook configuration2An empty certificate bundle makes admission fail closed.
Capability branching6The chart chooses apiVersions from the cluster it renders against.
Custom resource definitions23Per-file delivery can race the definitions the resources depend on.
Condition-gated subcharts1What renders depends on which conditions the values switch on.

A flattening-safety verdict has decided this version: default:flatten-with-routes; no-crds:flatten-with-routes. The verdict records one disposition per construct and names any companion artifact a flattened bundle must ship. What the flattening verdict means.

A construct being present does not make a chart unflattenable. Most are switched on or off by values, and a verdict records which ones the base you choose actually reaches. Read the catalog-wide evidence for how common each one is.

What The Starting Configuration Records

A base variant is a starting configuration we have already rendered and checked. Pick the one whose trade-off you want; the table below shows what each one changes. How the values for each are chosen.

The default base-variant record connects those Helm inputs to the Kubernetes objects, remaining requirements, hooks, CRDs, checks, and OCI status. Open it when you need the complete starting record rather than only the rendered YAML.

Open the full rendered YAML to read the actual manifest output. The render record and setup section explain the inputs, tests, CRDs, hooks, and other work around it.

If new Helm values create a useful starting configuration, record another base variant with its own inputs and checks. If one environment changes a field after rendering, record that change in a ConfigHub variant.

KeyWhere to look firstWhat it means
Package users pulloci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001The exact installer package for this chart version. The version tag is readable, and the manifest digest makes a published pull immutable. Public catalog package refs are published in Google Artifact Registry with anonymous read access. No ConfigHub account or Google registry login is needed for the local setup path.
Required before applySecret external-secrets/external-secrets-webhook
kubectl create namespace external-secrets --dry-run=client -o yaml | kubectl apply -f -
kubectl -n external-secrets apply -f <work-dir>/out/secrets/secret-external-secrets-external-secrets-webhook.yaml
External resources the recommended base variant expects, such as an existing Secret, namespace, CRD, or target fact.
Kubernetes objectsfull rendered YAMLThe full YAML captured from this base variant. It is the output of the render.
Render recorddefault render intentThe Helm inputs and evidence links that explain how the output was produced.
Complete starting recorddefault base-variant recordThe record that connects the Helm inputs, Kubernetes objects, remaining requirements, setup work, checks, and OCI status.
Hooks, CRDs, and setup workthis page's setup sectionInstructions and decisions for hooks, CRDs, generated Secrets, setup jobs, cluster requirements, or blockers.

Choose base variant

Pick the supported Helm configuration for this chart: default, no-CRDs, existing Secret, HA, server-only, or another listed option.

Record inputs

Keep the values, namespace, release name, source lock, default render intent, full YAML output, package base, test results, and setup instructions together.

Handle chart extras

CRDs, hooks, setup jobs, external Secrets, target facts, and webhook certificates are recorded as chart-specific choices. Some are included in a base variant, some need a setup step, and some are blocked until there is a safe path.

How render intents work · All generated render intents · All base variant records

Try This Chart

Start with default. If a card says review or preparation is needed, treat that as a real limit rather than a ready install.

Package image

Exact package: oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001
publication receipt recorded · open the exact publication receipt

Readable version tag: oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0. The package is pinned so a republished tag cannot change what you get. The command below uses the exact manifest digest, so cub installer refuses different package bytes.

Check the package identity

cub installer inspect oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001 --json

Read how each configuration was made

cub installer pull 'oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001' --work-dir ./package-review
less ./package-review/package/records/README.md

The package's records/ directory connects every base to its source choices, Helm render intent, Kubernetes objects, prerequisites, lifecycle work, and checks. These are supporting records, not Kubernetes objects.

Verify the package publisher

Run this command with cosign. It checks the expected publisher, the exact manifest digest, and the package annotations.

cosign verify --certificate-identity helm-expt-package-signer@nth-fort-499605-q5.iam.gserviceaccount.com --certificate-oidc-issuer https://accounts.google.com --annotations confighub.com/package-path=packages/external-secrets/external-secrets/2.5.0 --annotations confighub.com/package-sha256=c071847c2e9e7815915cd8a102f3daddc31880f822c7ddc49e23e29581fdcb3a europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001

A valid signature identifies who signed these package bytes. It does not show that the configuration is suitable for your cluster; use this page's checks and setup instructions for that decision.

Signature receipt · Sigstore bundle · How signature verification works

Public catalog package refs are published in Google Artifact Registry with anonymous read access. No ConfigHub account or Google registry login is needed for the local setup path.

Recommended first command

cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001 --base default --work-dir ./external-secrets-external-secrets-2-5-0-default --non-interactive --namespace external-secrets

Advanced: apply it or upload it

Run the whole sequence as one script, prerequisites included: try.sh renders and applies to Kubernetes without an account; confighub.sh renders and uploads to your ConfigHub Space.

Before you run try.sh: it changes your current kubectl context. It runs the named prerequisites and applies the rendered objects. Read it first and use a disposable test cluster. confighub.sh does not apply anything to Kubernetes.

You should see something like this

Here is what the command does. cub installer is an open-source plugin for the cub CLI. cub installer setup pulls a catalog package and writes its Kubernetes files locally, leaving delivery to kubectl, Argo CD or Flux. The generated scripts stop before doing any work when the plugin or kustomize is missing.

cub installer setup ...
rendered manifests written under <work-dir>
use the chart option cards below to check pass, watch, blocked, and prerequisites

Current status: Available in the catalog · Reason: Promotion was tested and recorded in ConfigHub.

Use this entry in ConfigHub

Every Catalog entry page carries these five steps in this order. Each step says what the Catalog has run for this entry, and a step with a missing precondition gives no command.

Steps 1 and 2 need no account. Install the cub CLI before any cub command. Step 2 uses cub config diff, which cub plugin install confighub/cub-workshop@v0.6.61 adds. This page covers 2 entries, so open the one you want. A live walk on 2026-10-08 ran steps 3 to 5 for bitnami-nginx-24-0-2-http-clusterip and nvidia-gpu-operator-v26-3-3-default. These commands carry the changes that walk needed. It is a dated log and no receipt, so no state on this page rests on it.

Helm chart, base default, version 2.5.0
What is fixed, and what you supply

Fixed when this entry was built. These went into the build, so the objects already carry them. To change one, build the entry again from its source.

  • chart is external-secrets/external-secrets
  • version is 2.5.0
  • base is default
  • valuesProfile is recipes/external-secrets/external-secrets/2.5.0/effective-values.yaml
  • namespace is external-secrets
  • releaseName is external-secrets
  • capabilityProfile is {"apiVersions":[],"kubeVersion":"1.30.0"}

Yours to supply or check. The destination must have these before the objects are applied. The words in italics say what the Catalog knows about each.

  • Rendered webhook Secret separated by installer and populated by the cert-controller after apply. kubectl -n external-secrets apply -f <work-dir>/out/secrets/secret-external-secrets-external-secrets-webhook.yaml Declared. Not checked on any destination.
This entry's plan, and how to test it

These are the steps that plain objects cannot carry. ConfigHub stores them and does not carry them out. The words in italics say what the Catalog knows about each.

  • Before you deliver. Secret external-secrets/external-secrets-webhook must exist before apply. Rendered webhook Secret separated by installer and populated by the cert-controller after apply. Who: operator. Written down. Not run by the Catalog.
  • When you deliver. Apply the 23 CustomResourceDefinition objects first. Wait until every named definition reports the Established condition. The listing gives the rest. Who: whatever applies the objects. Written down. Not run by the Catalog.

Test the install steps yourself. This script carries them out with kubectl on a cluster you choose, with no account. Read it first and use a throwaway cluster. The Catalog has no recorded run of this script.

Test the plain objects. A second script tests the retained objects themselves with kubectl, and it needs no cub and no account. The Catalog has no recorded run of this script.

Compared with plain Helm. The Catalog installed this base beside plain Helm on two local clusters, and the two matched. Read the receipt.

Read what a plan is, and why some entries have one.

1. Get the exact objects Run for this entry

The Catalog rendered this entry and retains its 42 objects in one file.

An upload can create more Units than the objects counted here. The installer renders a Namespace, and the upload adds an installer-record Unit.

# fetch the retained objects for this entry
$ curl -fsSL -o external-secrets-external-secrets-2-5-0-default.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/external-secrets/external-secrets/2.5.0/revisions/default/r001/rendered/release-objects.yaml

# check the bytes against the listing
$ shasum -a 256 external-secrets-external-secrets-2-5-0-default.yaml
f1c832a9af788c9d2a7a0b066d76a7d8af253d83f5b0fa39c1aa91271230d3db  external-secrets-external-secrets-2-5-0-default.yaml

# render this base from the signed package; step 3 uploads this directory
$ cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001 --base default --work-dir ./external-secrets-external-secrets-2-5-0-default --non-interactive --namespace external-secrets

2. Compare with another version or base Not run for this entry

The listing records no comparison for this entry. The commands run on the retained files, with no account. This version has one other base in the Catalog, no-crds. The Catalog holds 3 other versions, 2.7.0, 2.8.0 and 2.10.0.

# fetch the no-crds base of the same version
$ curl -fsSL -o external-secrets-external-secrets-2-5-0-no-crds.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/external-secrets/external-secrets/2.5.0/revisions/no-crds/r001/rendered/release-objects.yaml

# list what differs between the two bases
$ cub config diff external-secrets-external-secrets-2-5-0-default.yaml external-secrets-external-secrets-2-5-0-no-crds.yaml --summary

# fetch the default base at version 2.7.0
$ curl -fsSL -o external-secrets-external-secrets-2-7-0-default.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/external-secrets/external-secrets/2.7.0/revisions/default/r001/rendered/release-objects.yaml

# list what changes from 2.5.0 to 2.7.0
$ cub config diff external-secrets-external-secrets-2-5-0-default.yaml external-secrets-external-secrets-2-7-0-default.yaml --summary

3. Upload it as a variant Run for this entry

The Catalog saved this entry in ConfigHub. The commands use its signed installer package. Read the log of the live walk on 2026-10-08 · Read the record that states this.

Replace each value in angle brackets with a name of your own. The entry id may already exist as a Space in your organization, and the package name as a Component.

In the live walk, a Space named for the nginx entry's id and a Component named bitnami-nginx already existed, so the walk chose its own names. The --component flag sets the Component label the upload writes on the Space, which is the package name when you omit it.

The cub installer plugin reads your organization from CUB_CONTEXT and ignores --context. If you use a context other than your default, export CUB_CONTEXT first, or the plugin works in your default organization.

# sign in; steps 3 to 5 write to your ConfigHub organization
$ cub auth login

# upload step 1's directory as a Space of Units, under names you choose
$ cub installer upload --work-dir ./external-secrets-external-secrets-2-5-0-default --space <your-space> --component <your-component>

# list the Units the upload created
$ cub unit list --space <your-space>

4. Deploy it Not run for this entry

No delivery run is recorded for this entry. Argo CD has not run, Flux has not run, and kubectl has not run. The commands name the Target workshop/target, which cub cluster up --name workshop creates on a local kind cluster with Argo CD. Use your own Target for a real destination. The listing records one input that the destination must supply, so read it before you deploy. The coverage lanes record a local Kubernetes run for this base. They are separate from the delivery record this step reads. Read the log of the live walk on 2026-10-08.

Use the Space name you chose in step 3. The delete command is needed because the cloned installer-record Unit carries the Target and Argo CD v3.5.4 cannot read it, a defect seen on cub v0.8.7 and server v0.8.9.

Without that line the walk deployed nothing and Argo CD showed Unknown, while every cub command exited 0. The walk ran the four commands in this order and did not try them without the first publish.

ConfigHub shows nothing when Argo CD fails to read a Release. Run kubectl -n argocd get applications.argoproj.io and read the Sync column, because Healthy alone is not a pass. Argo CD took between 18 seconds and about 5 minutes to read a Release on a cluster made without argobot.

The walk made its cluster with cub cluster up --no-argobot. That command creates two Spaces, a Worker, a Target and a Trigger, opens ports 30010 to 30019 on the machine, and installs Argo CD from an unpinned upstream manifest.

Removing the ConfigHub side does not remove the workload. In the walk, deleting the Application Unit and the Spaces left the Application and its pods running, because the root Application does not prune.

# clone the base onto a Target as a dev variant
$ cub variant create dev <your-space> --target workshop/target --space-pattern "template:<your-space>-dev"

# publish the Release that the cluster's Argo CD pulls
$ cub release publish <your-space>-dev

# delete the installer record, which Argo CD cannot read
$ cub unit delete --space <your-space>-dev installer-record

# publish again without it
$ cub release publish <your-space>-dev

5. Promote a change Partly run for this entry

A promotion ran for this entry. It ran the preview and the promote. The delete and the publish below have no recorded run for this entry. Promotion carries a change in the base to the dev variant. The base changes when you edit a Unit or upload a newer version into the same Space. Read the log of the live walk on 2026-10-08 · Read the record that states this.

The promotion changes the dev Space and publishes nothing. It also adds the installer-record Unit back with the Target. The change reaches the cluster only after the delete and the publish.

The preview lists the whole installer record as added. In the walk, the preview of a one-label change to gpu-operator ran to 405 lines, and about 400 of them were that record.

# preview what the dev variant would take from the base
$ cub variant promote <your-space>-dev --dry-run -o mutations

# promote once you have read the preview
$ cub variant promote <your-space>-dev --change-desc "Pull the reviewed base forward"

# delete the installer record that the promotion adds back
$ cub unit delete --space <your-space>-dev installer-record

# publish the Release that carries the change
$ cub release publish <your-space>-dev
Helm chart, base no-crds, version 2.5.0
What is fixed, and what you supply

Fixed when this entry was built. These went into the build, so the objects already carry them. To change one, build the entry again from its source.

  • chart is external-secrets/external-secrets
  • version is 2.5.0
  • base is no-crds
  • valuesProfile is recipes/external-secrets/external-secrets/2.5.0/effective-values-no-crds.yaml
  • namespace is external-secrets
  • releaseName is external-secrets
  • capabilityProfile is {"apiVersions":[],"kubeVersion":"1.30.0"}

Yours to supply or check. The destination must have these before the objects are applied. The words in italics say what the Catalog knows about each.

  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.
  • External Secrets CRD managed outside this no-crds base Declared. Not checked on any destination.

The listing records 24 of these. This list shows the first 12.

This entry's plan, and how to test it

These are the steps that plain objects cannot carry. ConfigHub stores them and does not carry them out. The words in italics say what the Catalog knows about each.

  • Before you deliver. The installer package includes these CRDs as prerequisites/target-facts/no-crds-crds.yaml. Apply the missing CRDs server-side and leave existing CRDs under their current owner. The listing gives the rest. Who: delivery workflow. Written down. Not run by the Catalog.
  • Before you deliver. Secret external-secrets/external-secrets-webhook must exist before apply. Rendered webhook Secret separated by installer and populated by the cert-controller after apply. Who: operator. Written down. Not run by the Catalog.

Test the install steps yourself. This script carries them out with kubectl on a cluster you choose, with no account. Read it first and use a throwaway cluster. The Catalog has no recorded run of this script.

Test the plain objects. A second script tests the retained objects themselves with kubectl, and it needs no cub and no account. The Catalog has no recorded run of this script.

Compared with plain Helm. The Catalog installed this base beside plain Helm on two local clusters, and the two matched. Read the receipt.

Read what a plan is, and why some entries have one.

1. Get the exact objects Run for this entry

The Catalog rendered this entry and retains its 19 objects in one file.

An upload can create more Units than the objects counted here. The installer renders a Namespace, and the upload adds an installer-record Unit.

# fetch the retained objects for this entry
$ curl -fsSL -o external-secrets-external-secrets-2-5-0-no-crds.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/external-secrets/external-secrets/2.5.0/revisions/no-crds/r001/rendered/release-objects.yaml

# check the bytes against the listing
$ shasum -a 256 external-secrets-external-secrets-2-5-0-no-crds.yaml
da5857fba93e0394594d7e072b31e3cf28985392b5cc0443730a23b722d7670b  external-secrets-external-secrets-2-5-0-no-crds.yaml

# render this base from the signed package; step 3 uploads this directory
$ cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001 --base no-crds --work-dir ./external-secrets-external-secrets-2-5-0-no-crds --non-interactive --namespace external-secrets

2. Compare with another version or base Not run for this entry

The listing records no comparison for this entry. The commands run on the retained files, with no account. This version has one other base in the Catalog, default. The Catalog holds 3 other versions, 2.7.0, 2.8.0 and 2.10.0.

# fetch the default base of the same version
$ curl -fsSL -o external-secrets-external-secrets-2-5-0-default.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/external-secrets/external-secrets/2.5.0/revisions/default/r001/rendered/release-objects.yaml

# list what differs between the two bases
$ cub config diff external-secrets-external-secrets-2-5-0-no-crds.yaml external-secrets-external-secrets-2-5-0-default.yaml --summary

# fetch the no-crds base at version 2.7.0
$ curl -fsSL -o external-secrets-external-secrets-2-7-0-no-crds.yaml https://raw.githubusercontent.com/confighub/helm-expt/main/recipes/external-secrets/external-secrets/2.7.0/revisions/no-crds/r001/rendered/release-objects.yaml

# list what changes from 2.5.0 to 2.7.0
$ cub config diff external-secrets-external-secrets-2-5-0-no-crds.yaml external-secrets-external-secrets-2-7-0-no-crds.yaml --summary

3. Upload it as a variant Run for this entry

The Catalog saved this entry in ConfigHub. The commands use its signed installer package. Read the log of the live walk on 2026-10-08 · Read the record that states this.

Replace each value in angle brackets with a name of your own. The entry id may already exist as a Space in your organization, and the package name as a Component.

In the live walk, a Space named for the nginx entry's id and a Component named bitnami-nginx already existed, so the walk chose its own names. The --component flag sets the Component label the upload writes on the Space, which is the package name when you omit it.

The cub installer plugin reads your organization from CUB_CONTEXT and ignores --context. If you use a context other than your default, export CUB_CONTEXT first, or the plugin works in your default organization.

# sign in; steps 3 to 5 write to your ConfigHub organization
$ cub auth login

# upload step 1's directory as a Space of Units, under names you choose
$ cub installer upload --work-dir ./external-secrets-external-secrets-2-5-0-no-crds --space <your-space> --component <your-component>

# list the Units the upload created
$ cub unit list --space <your-space>

4. Deploy it Not run for this entry

No delivery run is recorded for this entry. Argo CD has not run, Flux has not run, and kubectl has not run. The commands name the Target workshop/target, which cub cluster up --name workshop creates on a local kind cluster with Argo CD. Use your own Target for a real destination. The listing records 24 inputs that the destination must supply, so read them before you deploy. The coverage lanes record a local Kubernetes run for this base. They are separate from the delivery record this step reads. Read the log of the live walk on 2026-10-08.

Use the Space name you chose in step 3. The delete command is needed because the cloned installer-record Unit carries the Target and Argo CD v3.5.4 cannot read it, a defect seen on cub v0.8.7 and server v0.8.9.

Without that line the walk deployed nothing and Argo CD showed Unknown, while every cub command exited 0. The walk ran the four commands in this order and did not try them without the first publish.

ConfigHub shows nothing when Argo CD fails to read a Release. Run kubectl -n argocd get applications.argoproj.io and read the Sync column, because Healthy alone is not a pass. Argo CD took between 18 seconds and about 5 minutes to read a Release on a cluster made without argobot.

The walk made its cluster with cub cluster up --no-argobot. That command creates two Spaces, a Worker, a Target and a Trigger, opens ports 30010 to 30019 on the machine, and installs Argo CD from an unpinned upstream manifest.

Removing the ConfigHub side does not remove the workload. In the walk, deleting the Application Unit and the Spaces left the Application and its pods running, because the root Application does not prune.

# clone the base onto a Target as a dev variant
$ cub variant create dev <your-space> --target workshop/target --space-pattern "template:<your-space>-dev"

# publish the Release that the cluster's Argo CD pulls
$ cub release publish <your-space>-dev

# delete the installer record, which Argo CD cannot read
$ cub unit delete --space <your-space>-dev installer-record

# publish again without it
$ cub release publish <your-space>-dev

5. Promote a change Partly run for this entry

A promotion ran for this entry. It ran the preview and the promote. The delete and the publish below have no recorded run for this entry. Promotion carries a change in the base to the dev variant. The base changes when you edit a Unit or upload a newer version into the same Space. Read the log of the live walk on 2026-10-08 · Read the record that states this.

The promotion changes the dev Space and publishes nothing. It also adds the installer-record Unit back with the Target. The change reaches the cluster only after the delete and the publish.

The preview lists the whole installer record as added. In the walk, the preview of a one-label change to gpu-operator ran to 405 lines, and about 400 of them were that record.

# preview what the dev variant would take from the base
$ cub variant promote <your-space>-dev --dry-run -o mutations

# promote once you have read the preview
$ cub variant promote <your-space>-dev --change-desc "Pull the reviewed base forward"

# delete the installer record that the promotion adds back
$ cub unit delete --space <your-space>-dev installer-record

# publish the Release that carries the change
$ cub release publish <your-space>-dev

After You Render It

The first command writes files and does not apply them. Read the objects and setup requirements, then choose the next job.

JobNext step
Render and inspect without applyingRun the recommended cub installer setup command above.
Run shared local configuration checkscub plugin install confighub/homebrew-tap@cub-scan-v0.7.3 --name scan
cub check --format json --output cub-check.json <work-dir>/out/manifests. The check is advisory and does not apply anything.
Apply the rendered manifests with kubectl, or publish reviewed objects as OCIPublish reviewed objects as OCI or apply the manifests with kubectl.
Save the reviewed result for a teamSave and upload the reviewed result to ConfigHub for shared history, exact diffs, and approvals.
Compare development and production, audit an exact diff, promote, or roll backBuild a promotion review or read the bounded rollback example.
Assign the configuration to clusters and operate a small fleetChoose targets, preview a wave, and inspect every result.
Check delivery limitsRead the current limits before choosing kubectl, Argo CD, or Flux.
Handle CRDs on the first installRead the CRD ordering risk and first-install guide, then check this chart's recorded owner and plan.

Available Configurations

Each card is one available way to use this chart in the catalog. Some cards are runnable base variants. Others are candidate paths, derived variants, or review notes that explain what still has to be prepared.

Checks: Each card names what was checked and says whether it passed, needs review, was blocked, was not run, or was not needed.

3 matrix rows for external-secrets/external-secrets@2.5.0 · open the full matrix

F1 · Source chart

(source)

Source

Pinned upstream chart and version

Status
Available in the catalog
How to run
This is the upstream chart source. Choose a base card below before running the installer.
Evidence
Pinned chart source and dependency lock
Hooks/actions
No separate hook or action for this row.
Who runs actions?
No separate action runner for this row.
Next
Choose a chart configuration before rendering or deploying
Reason
This is the chart source. Choose a configuration before checking deployment or promotion
Helm outputNot neededSaved in ConfigHubNot neededLocal clusterNot neededSetup stepNot neededGitOps and OCINot neededLive Helm comparisonNot neededTwo clustersNot neededPromotionNot needed
F2a · Chart default

default

Base

Runnable base variant made from the chart defaults

Status
Available in the catalog
Helm values
effective-values.yaml
ConfigHub changes
None in this catalog base. After upload, read Unit revision history or the derived variant.
How to run
cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001 --base default --work-dir ./external-secrets-external-secrets-2-5-0-default --non-interactive --namespace external-secrets
Scripts
try.sh renders, settles the prerequisites in order, and applies with kubectl; confighub.sh renders and uploads to your ConfigHub Space.
Evidence
Live helm vs confighub parity
Hooks/actions
No separate hook or action for this row.
Who runs actions?
No separate action runner for this row.
Lifecycle record
The current review found no separate hook or setup step for this base. Open the full record.
Prerequisites
1 prerequisite is declared for this base. Each prerequisite says whether it must be checked before render or before apply.
Next
Image policy decision recorded for a target scope; Create digest pinned bases or overrides for stricter scopes
Reason
Promotion was tested and recorded in ConfigHub.
Helm outputPassedSaved in ConfigHubPassedLocal clusterPassedSetup stepPassedGitOps and OCIBlockedLive Helm comparisonPassedTwo clustersPassedPromotionPassed
F2b · Helm-rendered base

no-crds

Base

Runnable base variant made with different Helm values

Status
Available in the catalog
Helm values
effective-values-no-crds.yaml
ConfigHub changes
None in this catalog base. After upload, read Unit revision history or the derived variant.
How to run
cub installer setup --pull oci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001 --base no-crds --work-dir ./external-secrets-external-secrets-2-5-0-no-crds --non-interactive --namespace external-secrets
Scripts
try.sh renders, settles the prerequisites in order, and applies with kubectl; confighub.sh renders and uploads to your ConfigHub Space.
Evidence
Live helm vs confighub parity
Hooks/actions
No separate hook or action for this row.
Who runs actions?
No separate action runner for this row.
Lifecycle record
The current review found no separate hook or setup step for this base. Open the full record.
Prerequisites
24 prerequisites are declared for this base. Each prerequisite says whether it must be checked before render or before apply.
Next
Image policy decision recorded for a target scope; Create digest pinned bases or overrides for stricter scopes
Reason
Promotion was tested and recorded in ConfigHub.
Helm outputPassedSaved in ConfigHubPassedLocal clusterPassedSetup stepPassedGitOps and OCIBlockedLive Helm comparisonPassedTwo clustersPassedPromotionPassed

Local Configuration Checks

We ran cub check v0.7.3 against the exact rendered objects for every configuration below. The result is advisory: read each finding and decide whether it matters for your target.

Scanner and ruleset identity

Pattern bundle: v0.7.3
Bundle manifest: sha256:0405f6ffe21e567adf5d6a732d181c7f228194920456d046b4338baeb14de1a8
Risk catalog: sha256:7ff79a126ad99bba2505fec8b2b7711c03f50eb362141128ec1c83e27a5036ba

ConfigurationAdvisory resultExact inputCheckedEvidence
default15 advisory findings
3 critical, 9 warning, 3 info
ClusterRole grants secrets read permissions
ClusterRole grants serviceaccounts/token create
Deployment containers omit resource limits
42 objects
sha256:8337435f9d539a548bbe3eb48f4a6ee938c6023024b75d129da0019a56fbe499
2026-09-16Full cub check result
Exact YAML
Separate Catalog review
no-crds15 advisory findings
3 critical, 9 warning, 3 info
ClusterRole grants secrets read permissions
ClusterRole grants serviceaccounts/token create
Deployment containers omit resource limits
19 objects
sha256:775515f281e72afecb71f2f4bf1506ed85ed35e01d4163718c71df855777a9ff
2026-09-16Full cub check result
Exact YAML
Separate Catalog review

What this does not check: hook execution, CRD readiness, target Secrets and cloud services, admission behavior, workload health, or rollback. The linked Catalog review covers chart-specific source and operating questions. ConfigHub validation and approval are separate managed controls.

Read all shared check results and the mapping to Catalog rules.

Images This Chart Pulls

Every reference below comes from the reviewed rendered output. What you see is what the cluster pulls. These references are data: you can change a registry or pin a digest with a recorded edit, and prove the change landed in every environment.

Base variantImages
defaultghcr.io/external-secrets/external-secrets:v2.5.0
no-crdsghcr.io/external-secrets/external-secrets:v2.5.0

First-Run Caveats

Some chart paths need a small preparation step before the cub path feels as smooth as Helm. We show those steps here so the first run does not surprise you.

CaveatWhat to do
Universal caveatsUse declared inputs or bases instead of Helm --set. For direct delivery, define pruning and field-conflict behavior. Use Argo CD or Flux when that controller path and its pruning settings are recorded for the selected preset.
Shared placeholder passwordNo shared placeholder password caveat recorded for this chart.
CRD first-orderingYes. 25 CRD object(s) are recorded. Follow the base's recorded plan: apply CRDs first and wait, use a controller-specific ordering rule, or choose the separable CRD base when one is available.

Open the all-chart adoption caveats · Helm to cub migration · cub deployment path

Advice And Current Status

Use this section to see which chart-specific guides apply, what you must provide, and what work remains.

PlaybookWhy it applies
Serious Chart Playbooksa named hard chart, or one that combines CRDs and admission webhooks
Large App Evidence Funnelrenders many Units, so a single pass/fail can hide where an operation is stuck
Live Parityhas live, GitOps/OCI, or two-cluster parity work
QuestionCurrent answer
User statusReady to try
Can I use it?Use the public catalog entry, then check the exact configuration and its tests.
First basedefault
Exact installer packageoci://europe-west1-docker.pkg.dev/nth-fort-499605-q5/helm-expt/external-secrets-external-secrets:2.5.0@sha256:3360d8a7d2d83748808b0f4a66969feaa33b305312dcb8bbe956fec08407b001
Tests completedCatalog supported with live evidence (render parity 2/2; Local live 2/2; Live parity 2/2)
CoverageCovered
You must providean existing Secret for some bases (buildable - not yet run); a CRD ownership choice (crds vs no-crds base)
What the tools recordexact rendered objects with render parity and receipts; CRD handling split into explicit bases; optional chart inputs handled by reviewed base configurations
Next actionimage policy decision recorded for a target scope; create digest-pinned bases or overrides for stricter scopes

The source data lives in chart skills and chart evidence router.

What Has Been Tested

Choose the question you care about. Not checked means this catalog has no version-specific result; it is not a pass.

QuestionStatusEvidence
Can I pull these exact package bytes again? Checked Package receipt
What does this chart contain? Checked Source lock · Chart guide · Render result · All 6 evidence links
Does the recorded render match Helm? Checked Render result 1 · Render record · Render result 2 · All 4 evidence links
Did the supplied values change the render? Not checked No linked result
Were hooks, CRDs, or setup steps checked? Checked Version results below
Did this version run on a local Kubernetes cluster? Checked Version results below
Did an OCI delivery through GitOps run? Not checked No linked result
Did Helm and ConfigHub reach the same live result? Checked Live comparison 1 · Live comparison 2
Was the result compared on separate clusters? Checked Version results below
Was a ConfigHub promotion tested? Checked Promotion receipt 1 · Promotion receipt 2
Did this version string point at changed upstream bytes? Not checked No linked result

How much is proven, and what more testing would add: Fully proven: Render parity, ConfigHub proof, Local live, GitOps/OCI live, Live Helm-vs-ConfigHub, Two-cluster kind.

BaseReadinessRenderConfigHubLocal liveGitOps/OCILive parityTwo-cluster kind
defaultstart-herepasspasspasspasspasspass
no-crdsstart-herepasspasspasspasspasspass

What You Must Provide

exact rendered objects with render parity and receipts; CRD handling split into explicit bases; optional chart inputs handled by reviewed base configurations

FieldValue
Known quirksCrds; Existing secret; optional chart inputs
You must providean existing Secret for some bases (buildable - not yet run); a CRD ownership choice (crds vs no-crds base)
What ConfigHub recordsexact rendered objects with render parity and receipts; CRD handling split into explicit bases; optional chart inputs handled by reviewed base configurations
Optional chart inputsRaw/extra manifests; Tpl powered values
How optional inputs are handledKeep empty in supported bases; Or make a reviewed installer base when populated

Hooks, CRDs, And Setup Work

Some Helm charts need work before, during, or after apply: CRDs, hooks, setup jobs, webhook certificates, migrations, generated Secrets, or checks. For each chart, the catalog should make the choice clear: include it in the base variant, split it into a separate base variant, run a setup step, use a GitOps action where evidence exists, require an existing target resource, or block it when there is no safe default.

What each base needs before apply

These requirements come from the same base definition as the rendered objects. The render intent keeps the chart inputs, required Secrets or CRDs, lifecycle steps, and evidence together.

Base variantRequired resourceHow to provide itFull record
defaultSecret external-secrets/external-secrets-webhookkubectl create namespace external-secrets --dry-run=client -o yaml | kubectl apply -f -
kubectl -n external-secrets apply -f <work-dir>/out/secrets/secret-external-secrets-external-secrets-webhook.yaml
full render intent
no-crdsSecret external-secrets/external-secrets-webhookkubectl create namespace external-secrets --dry-run=client -o yaml | kubectl apply -f -
kubectl -n external-secrets apply -f <work-dir>/out/secrets/secret-external-secrets-external-secrets-webhook.yaml
full render intent
no-crds23 CRDsIncluded in the OCI package as prerequisites/target-facts/no-crds-crds.yaml. It applies missing CRDs server-side. The generated try script leaves existing CRDs under their current owner and waits for them before the workload.full render intent

If no plan is shown, that does not prove the upstream chart has no hooks. It means the public catalog has no chart-specific action to show yet; check the matrix or send a problem chart if hook behavior should be modeled. Direct apply, Argo CD, Flux, and upgrade implementations are tracked separately. One passing implementation does not prove the others.

Modeled action areaCurrent status
Checks and policies already reviewedCRD lifecycle and upgrade policy; cluster RBAC review; optional input sources and scan policy; warning review and apply-gate policy; cluster requirement checks before deployment; webhook readiness and failure policy
Why this lifecycle status is shownLifecycle observations:2/2
Lifecycle test recordsOpen lifecycle record 1
Open lifecycle record 2
Production review recordsOpen review record 1
Open review record 2
Open review record 3
Open review record 4
Open review record 5
Open review record 6

Before Production

A green render or local live result is not a production support claim. Production support is target-scoped and uses the support-decision artifact when present.

FieldValue
Production review statusReady for a target-specific production review
Target-scoped support decisionsupported
Supported basedefault
Target scopevanilla kind (historical receipt); namespace=external-secrets; delivery=confighub-oci; controller=argo
Accepted limitsCRD lifecycle and upgrade policy; cluster RBAC review; optional input sources and scan policy; warning review and apply-gate policy; cluster requirement checks before deployment; webhook readiness and failure policy
Open policy decisionsNone recorded for this policy checklist
Next actionKeep the target-scoped evidence fresh before using this supported scope as a production-support example; create separate provider-specific, credential, resource-hardened, or profile-specific bases for real customer External Secrets workloads.

Source And Evidence Files

ArtifactPath
Chart catalogrecipes/external-secrets/external-secrets/2.5.0/CATALOG.md
Machine-readable listing (default)site/listings/external-secrets-external-secrets-2-5-0-default.json
Machine-readable listing (no-crds)site/listings/external-secrets-external-secrets-2-5-0-no-crds.json
Helm render intentsdata/helm-render-intents/summary.md
Base variant recordsdata/base-variant-records/summary.md
First render intentdata/helm-render-intents/intents/external-secrets-external-secrets-2-5-0-default.yaml
First base variant recorddata/base-variant-records/records/external-secrets-external-secrets-2-5-0-default.yaml
Full rendered YAMLrecipes/external-secrets/external-secrets/2.5.0/revisions/default/r001/rendered/release-objects.yaml
Reciperecipes/external-secrets/external-secrets/2.5.0/recipe.yaml
Packagepackages/external-secrets/external-secrets/2.5.0
Installer OCI package catalogdata/installer-oci-packages/summary.md
Installer OCI publication receiptruns/installer-oci/external-secrets-external-secrets/2.5.0/installer-package-publication-receipt.yaml
Helm pain reportrecipes/external-secrets/external-secrets/2.5.0/helm-pain-report.yaml
Production review recordsdata/production-disposition/summary.md
Support decisiondata/production-support-decisions/external-secrets-external-secrets/support-decision.yaml
Base readinessdata/top20-base-readiness/summary.md
Chart skillsdata/chart-skills/summary.md
Chart evidence routerdata/chart-evidence-router/summary.md
Current test statusdocs/user/current-proof-status.md

Technical notes and disclaimers

  • default. The plain-objects script stops before it applies anything. One step of the plan is yours to do first, and it prints it. When you run it again it applies the objects and ends. It does not wait for the workloads to start. Neither script runs the steps the plan names for an upgrade or a delete.
  • no-crds. The plain-objects script stops before it applies anything. 2 steps of the plan are yours to do first, and it prints them. When you run it again it applies the objects and ends. It does not wait for the workloads to start. Neither script runs the steps the plan names for an upgrade or a delete.

Generated from the catalog data and linked test results. Check the current evidence before using a configuration in production.