Browse Config
Catalog
Config
Stacks
Operate
Docs

Is my configuration right?

“Here is the chart and values my AI produced. Compare them with the chart defaults, any matching Catalog record I provide, and what I run now. Tell me what matters, then give me a reviewed result I can keep.”

Use this page for your own chart, values, new version, or unexpected result. Use the Catalog when we have already tested the exact chart and version.

In the website: compare rendered Kubernetes YAML in this browser, with no AI needed, or build local instructions for the AI assistant you already use. Render your chart with helm template first, then paste the objects. Download the exact objects, findings, file hashes, and checks that did not run.

On the command line: render or extract the same objects with cub helm, cub installer, or the source tool named by the example. Run cub check on those files for the shared local configuration checks. The page gives you copyable commands for keeping the same files and hashes in ConfigHub.

Checking private configuration? Keep the chart, values, and output on your machine. Do not upload private files; this page does not upload them for you. Keep secrets out of the form, AI prompt, and any public issue.

Keep the result locally, publish the reviewed objects as OCI, or retain the same result in ConfigHub when a team needs history and promotion.

Already accepted a result? Compare the exact current result with the candidate for the next stage. The promotion review shows what changed, what blocks the move, and which destination checks have not run.

Doing this regularly? Install the ConfigHub Workshop agent skill so your assistant follows the same version, evidence, lifecycle, and safety rules.

Start with my chart and values I have rendered YAML

Other common jobs

Render and inspect without applying · Compare development and production · Handle hooks and CRD ordering · Read delivery limits

What this page can answer

QuestionWhat happens here
What do I have?The page inventories and compares the exact rendered objects you provide. A local assistant can also inspect the source, values, or package.
What will it produce?Helm, AICR, Timoni, or another source tool runs on your machine. The browser checks its output; it does not run the source processor.
Can this destination accept it?Not from browser files alone. Run a destination check with the exact candidate and current target facts.
Did it work?Not before deployment. Record controller, resource, runtime, drift, and rollback results after the exact revision is delivered.

Already comparing GPU nodes rather than a deployable configuration? Use AICR snapshot and diff. That read-only path needs cluster access but no recipe or bundle deployment.

Start with a chart and values

Choose one question. This form does not upload a values file or render Helm in your browser. It builds instructions for the Claude, Codex, or other AI assistant already running on your machine. The assistant runs Helm locally, records the inputs, and compares the exact objects.





Search the Catalog for this chart and version. Use a tested record when one exists; keep investigating locally when it does not.


Optional comparison: add what you run today

Compare the candidate with an older version, an installed Helm release, local YAML, OCI, Git, or live Kubernetes output. Everything stays on your machine.




Run the shared checks on your machine

Use this after Helm, AICR, OCI, or another source tool has written Kubernetes YAML. The command checks the exact files on your machine. It does not upload them, contact ConfigHub, or apply them to a cluster.

New to cub? Install the cub CLI first. Public catalog packages pull and render anonymously, and you sign in only once a command saves or changes ConfigHub data.

cub plugin install confighub/homebrew-tap@cub-scan-v0.7.3 --name scan
cub check --format json --output cub-check.json ./rendered

cub-check.json records stable finding IDs and the pinned pattern bundle used for the check. Keep it beside the rendered files and their digest. The result is advisory: cluster admission, hooks, CRDs, workload health, upgrade behavior, and rollback still need their own checks.

See the same three jobs through the website and released cub commands. The Helm and plain-YAML examples use the same WorkshopResult record and carry one canonical object-set hash into the ConfigHub upload.

See what a completed review looks like

In the worked NGINX case, the proposed values produced six local findings and an unwanted public LoadBalancer. The reviewed result fixes six problems and keeps one emptyDir finding visible under a narrow, dated exception for development and staging only.

The same record then follows the accepted objects into ConfigHub, through a development-to-staging promotion, and into two Argo CD test deployments. Each step says what it proves and what it does not prove.

Open the completed review

For a lifecycle-heavy upgrade, read the Kube Prometheus Stack 85.3.3 to 86.1.0 destination result. It checks namespaces, CRDs, server-side apply, prerequisites, approval, release OCI, and Argo CD separately.

Or: Check rendered objects in this browser

Add the exact rendered candidate. Add a second object set when you want to compare it with defaults, an older version, production, OCI, Git, or exported live objects.

Helm, AICR, and Timoni must produce their Kubernetes objects locally first. This browser checks those objects; it does not run the source tool.

The browser records object identities and hashes, reports added, removed, and changed objects, and checks a short list of common manifest risks. This is a first check, not a Helm render, Kubernetes schema check, admission test, hook run, or live health test.

The checks on this page run in your browser. This page does not send your files to an AI service. You may use your own Claude, Codex, or other AI assistant to investigate findings or propose fixes. Check its proposed commands, objects, and evidence before accepting them.

Do not add credentials or Secret values. Keep private source names and paths local. The optional public Catalog proposal is only for material you are allowed to publish.



Candidate objects

Comparison objects (optional)

Add a Catalog source and intent record

If the candidate starts from a Catalog configuration, add its BaseVariantRecord. It connects the source, rendered objects, OCI package, prerequisites, lifecycle routes, policy, and evidence status.

Add the result from cub check (optional)

Run the shared checks on the same candidate files, then add cub-check.json. The page accepts it only when its object count and object-set hash match these exact objects. The result remains local advisory evidence; ConfigHub validation is a separate managed check.

You can add a local check result for this candidate.


Four common Helm questions

These four came up most often in a review of forty recent public Helm discussions.

QuestionAnswerStart
What will this install, and what must already exist?List the rendered objects and every required namespace, Secret, CRD, API, storage class, cloud service, hook, and setup job.Start this check → · 8 of 40 discussions
How is this candidate different from production?Compare the two exact object sets and their source records. Keep desired-configuration differences separate from live-cluster drift.Start this check → · 6 of 40 discussions
I set a value. Why did the rendered object not change?If Helm ignored a setting, check first for a misspelled or wrong values path. Render with and without the value, identify the correct path, or report that the chart does not expose the field.Start this check → · 5 of 40 discussions
The chart does not expose the field I need. Must I fork it?Show the rendered object and missing field. Keep the chart unchanged when a reviewed post-render edit is enough, then check that edit for overlap on upgrade.Start this check → · 5 of 40 discussions

Questions people are asking

We reviewed 40 recent public Helm discussions before starting outreach. The counts describe that small research sample; they are not customer or site usage totals.

Choose the question closest to the decision you need to make. Each link selects it in the form above.

Recent discussionsQuestionWhat the answer should contain
8What will this install, and what must already exist?List the rendered objects and every required namespace, Secret, CRD, API, storage class, cloud service, hook, and setup job.
6How is this candidate different from production?Compare the two exact object sets and their source records. Keep desired-configuration differences separate from live-cluster drift.
5I set a value. Why did the rendered object not change?If Helm ignored a setting, check first for a misspelled or wrong values path. Render with and without the value, identify the correct path, or report that the chart does not expose the field.
5The chart does not expose the field I need. Must I fork it?Show the rendered object and missing field. Keep the chart unchanged when a reviewed post-render edit is enough, then check that edit for overlap on upgrade.
4Can I upgrade this chart without breaking production?Render both versions with the same release context. Compare objects, hooks, CRDs, immutable fields, storage, Secrets, and the current Helm release record when available.
4How should Argo CD or Flux handle this chart's hooks and CRDs?List each hook, CRD, and setup job in order. State who runs it, what must already exist, and which controller path has been tested.
3Where does this vulnerable image run, and how can I update it safely?Search supplied estate or ConfigHub records, show every affected environment and cluster, test the candidate, and promote it through a limited rollout wave.
2Can I roll back to exactly what ran before?Find a retained rendered revision or OCI digest and restore those exact objects. Keep database migrations and other external effects outside the configuration claim.
2Do these version and digest records identify the same bytes?Record the available chart and package digests and compare them with retained, dated evidence.
1AI wrote these values. What did they actually change?Render the candidate and compare it with the chart defaults, the Catalog, and optionally the current deployment. Show exact changes and check credentials, permissions, images, storage, hooks, and CRDs.

What happens to a public question

Submit only a public chart after you have a useful local result. Proposing a public case is one of the three public jobs. We aim to acknowledge a complete report within two business days. Within seven days, we aim to post one clear outcome: a Catalog entry, a named warning, a refusal, or a request for more evidence. See current question totals and outcomes · Read the response process

Find a direct answer

Use this FAQ when one question blocks your next step. It covers Helm compatibility, ConfigHub, hooks, CRDs, values, upgrades, free use, and current limits. Each answer says what works, what remains limited, and where to check the evidence.

1. Start with the basics

Is this just Helm with extra paperwork?

answered

No. You keep your Helm charts and values. The Catalog adds tested starting configurations and shows their exact Kubernetes objects. ConfigHub stores the reviewed objects, the approvals, and the release history.

Do I have to rewrite my charts?

answered

No. Keep your charts, values, templates, and current delivery tools. This project helps you inspect and manage the objects they produce.

How is cub installer different from cub helm?

answered

cub helm starts with any chart and values. It can render locally or record the rendered base and Helm source in ConfigHub. cub installer starts with a maintained Catalog package containing named configurations and requirements. Both are optional preparation tools.

Do you support every Helm values combination?

answered

No. A chart can expose too many combinations to test as one claim. The Catalog covers common operating choices with chart-specific base variants. Examples include no-CRDs, existing Secret, server-only, HA, and internal service.

Isn't that case-specific?

answered

Yes. That is deliberate because Helm charts have different operating choices. AI can help update the configurations across versions, but tests decide what the Catalog accepts.

What is a base variant?

answered

A base variant is one supported way to render a chart version, with its Helm values, rendered YAML, and extra install work all recorded together.

Does it only work for easy charts?

answered

No. Redis teaches the basic path. The kube-prometheus-stack example covers CRDs, webhooks, RBAC, generated values, cluster requirements, upgrades, and live checks.

What do the current generated counts say?

answered

The counts come from committed test results. Use them for orientation, then open the matrix for the exact chart, version, and configuration.

246/246Render parity
198/246In-ConfigHub proof
148/246Local live
139/246GitOps/OCI live pass
139/246Live Helm-vs-ConfigHub parity pass
126/246Complete core lanes
2. Follow the configuration into ConfigHub

How does it actually work, end to end?

answered

Choose a chart configuration and record its Helm values and render settings. Inspect the Kubernetes YAML and handle its required setup. ConfigHub can then store, change, approve, and release the reviewed objects. Delivery and live checks remain separate recorded steps.

How is config delivered, and what about OCI and credentials?

answered

ConfigHub publishes the reviewed Units in one Space as a release OCI. Argo CD or Flux pulls it without rendering Helm again. A separate direct local test checks that the same artifact is portable. A hook fixture proves the mechanism, and an NGINX receipt proves one catalog base at one digest. Other bases need their own receipts. cub cluster up installs the Argo CD pull credential. The Flux test copies it into flux-system without printing it.

How do upgrades and rollback work?

answered

ConfigHub compares the candidate with the Kubernetes objects you already reviewed. It publishes the approved result as OCI. Every Unit keeps its revision history. The Redis live test restored the exact pre-upgrade revisions and published a rollback OCI. It then tested both clusters again. This restores configuration, not database data. Irreversible migrations still need a chart-specific recovery plan.

What is a Unit, a space, or a target?

answered

A Unit is one versioned desired-state record. A Space holds related Units. A Target defines where ConfigHub delivers them. An OCI Target publishes the Space as a bundle.

I already run Argo or Flux. What changes?

answered

You keep your controller. Point it at the OCI bundle that ConfigHub publishes from reviewed Units. The controller no longer rerenders Helm values from Git. Hooks become recorded routes with named execution steps.

What is safe for AI to change?

answered

Ask AI to propose a new base, derived variant, policy change, or object patch. ConfigHub can show the diff and require tests or approval. Do not let AI rewrite live state or bypass the recorded change path.

3. Handle hooks, Secrets, and cluster requirements

What happens to hooks, CRDs, and other required setup?

answered

Each chart page names the hidden work and gives it a route: a lifecycle phase, who runs it, and one of five dispositions. Every route stays automatic: false until ConfigHub can select and run it for you, so a green render never proves a hook, a CRD, or a target fact is handled.

Where do Secrets and credentials live?

answered

Do not hide them inside ConfigHub by accident. The catalog separates generated Secrets, existing-Secret references, target facts, and runtime Secret lifecycle where the chart requires that distinction.

4. Check delivery, upgrades, and live results

Can one change roll out across a whole fleet safely?

answered

Yes, within recorded bounds. The fleet record predicts which objects a base change touches in each environment. Environments shielded by their own override are marked. A live receipt shows one reviewed edit fanned out to three environments, each behind its own approval. Beyond the recorded fleets, no claim is made.

Can I trust a green GitOps sync?

answered

Not by itself. Sync means the controller accepted the desired state. Workload convergence, target prerequisites, controller-owned fields, and semantic parity need separate evidence.

What if a Helm upgrade caused a production crash?

answered

The model breaks the upgrade into visible steps: old render, new render, object diff, and live checks. That reduces opaque upgrades. It does not promise crash-free production.

What should I do with non-green rows?

answered

Use the matrix to read the reason. A watch, blocked, refused, or n/a cell can be the correct answer when the reason is named and linked.

Can a live Kubernetes fix flow back into desired ConfigHub state?

P1 backlog

Not as a shipped product path yet. The reverse-reconcile design defines authority, scoped write-back, attribution, and round-trip proof. The product still needs a gated command and live proof.

5. Understand values, variants, and Catalog coverage

Can I bring my own values files or overlays?

answered

Yes. Variants explains exactly which changes need a new base and which fit a derived ConfigHub variant.

Can I load my existing app, platform, stack, or live cluster?

answered

Yes. Start with a read-only discovery or import. Review the sources, targets, objects, labels, and owners. Then keep the imported Units, create a recipe, or build a managed application.

Which path should I take?

answered

Use the public catalog when a reviewed base variant exists. Use plain Helm when the chart still needs a better base variant or limitation decision. Variants explains when to create a new base and when to create a derived ConfigHub variant. Ask for managed help when private charts, teams, approvals, fleet operations, or production responsibility enter the path.

I know Helm flags. Why does cub reject --set or -f values.yaml?

answered

cub installer uses declared inputs and named bases instead of Helm's free-form --set model. Today cub rejects those Helm habits safely, but the errors are still too opaque. Use the migration guide until the CLI teaches this directly.

Where would a Helm user go back to Helm today?

watch

The adoption audit lists places where cub is harder than Helm today. They include defaults, one-value changes, direct upgrades, CRD ordering, uninstall, and rollback. Use Helm when one of these gaps blocks a reliable cub path.

How much of the top-100 is ready for a user?

answered

The catalog does not make one claim for all 100 charts. Some are ready to try. Others need cluster prerequisites, operator review, or a better base.

20Ready to try
15Needs target prerequisites
30Needs operator review
38Needs a better base

Can the catalog prove every values combination for a chart?

P1 backlog

No. Claims are per chart, version, base, values path, test, and target profile. A new values file or overlay needs its own render, scan, receipts, and live evidence.

Can every top-100 or top-500 chart become ready-to-run?

P1 backlog

Not yet. The top-20 has the strongest evidence. The top-100 has clearer readiness records. Most top-500 entries remain analysis and triage data until they gain recipes, bases, and receipts.

6. Understand free use and the evidence

What is free and what needs ConfigHub?

answered

Public catalog browsing, local render checks, and catalog package setup are free or low-friction. Private catalogs, teams, approvals, application variants, promotions, fleet operations, and production responsibility are ConfigHub-managed.

What can we build once the objects are data?

answered

The RBAC report tests every committed default render without a cluster or another Helm run. A live example removes unnecessary Secret access. It requires approval, publishes the reviewed objects as OCI, and verifies the Argo CD result on Kubernetes.

What should I do if this breaks on my chart?

answered

Send the public chart and values that expose the problem. The expected response is a public fixture and a pass, watch, blocked, refused, or routed gap with evidence.

My Helm chart broke. Can this help me triage it?

answered

Start by comparing the rendered objects. Inspect cluster prerequisites, lifecycle routes, image pulls, controller status, and workload health. Then classify the problem as a recipe gap or a cluster runtime gap.

Are signatures enough to establish trust?

P1 backlog

No. Signatures help integrity and transport. Trust also needs signer authority, policy context, scans, gates, and live evidence. Keep that boundary visible.

7. Read current limitations

Can ConfigHub replace every production operator decision?

answered

No. Some decisions stay with a person, and the records say which. Every production disposition names its decision and its owner. Charts that need a custom discussion are marked in the matrix rather than automated over.

Do default bases generate fresh passwords?

answered

No. Keep credential material outside the render. For affected charts, the package default now uses an existing Secret and renders no shared password. The page gives you a command to create fresh Secret material before apply. Fixed-password demo bases are explicit, non-default choices. The published check covers 12 selected defaults with known credential behavior; it is not a catalog-wide credential audit.

Does cub-direct remove resources that disappear during an upgrade?

watch

Plain kubectl apply does not prune. The no-controller cub-direct path can orphan removed resources unless it uses kubectl apply --prune with a safe selector or allowlist, or another explicit delete-set. Argo CD and Flux can remove omitted objects only when pruning is enabled. Argo CD automated pruning is off by default; a Flux Kustomization uses spec.prune: true.

Can cub-direct first-install CRD charts without ordering?

watch

Not safely yet. A plain apply of a bundle that contains both a CRD and a custom resource can apply the custom resource before the CRD is established. The no-controller path needs CRD-first ordering and a wait/retry step, or a controller that handles ordering.

Does cub-scout catch every live drift?

watch

No. The current live gap proof shows cub-scout detects replica drift but misses container environment-variable drift. Drift detection is valuable, but it must state field coverage until pod-spec coverage is complete.

What happens if someone manually edits a field and cub re-applies?

watch

cub's managed delivery uses server-side apply. If someone edits the same field by hand, Kubernetes can block cub instead of silently overwriting the change. That can be safer, but the CLI must explain it and offer a clear reconcile or force path.

What happens next

ResultNext step
The Catalog already covers the caseUse its retained package, useful configuration, setup instructions, and evidence.
The review finds a values problemCorrect the value and render again. Keep the new object hash with the review.
The review finds a credential surpriseDo not deploy it. Replace the literal or placeholder with an existing Secret, then check the reviewed objects again. See one NGINX configuration go from local finding to ConfigHub gate to promotion, find configurations that use existing Secrets, or read the credential limitation.
The render is surprisingDo not deploy it yet. Compare it with the defaults and the configuration you run now, correct the cause, then render and check it again.
The chart does not expose the required fieldKeep the chart when possible and record the smallest object change as a ConfigHub variant.
The configuration needs hooks, CRDs, Secrets, or setup workChoose an explicit owner and order. Use only a delivery route whose evidence covers that work.
The result should remain portableKeep the YAML and review record locally, or publish the reviewed files as OCI.
A team needs history, promotion, or rolloutSave the reviewed result in ConfigHub, then create variants, approve changes, publish releases, and compare desired with live state.

Additional references: Helm investigation details · hooks and CRD setup · delivery limitations · checks and publication receipts · promotion and fleet examples

This page runs in your browser. It has no telemetry and sends nothing until you choose a public GitHub issue.