---
title: "Infisical Kubernetes Operator Guide: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/infisical-kubernetes-operator/
description: "Infisical skill for running the Infisical Kubernetes Operator: syncing secrets into Kubernetes Secrets and ConfigMaps, pushing secrets back to Infisical, and managing dynamic secret leases in-cluster."
---

# Infisical Kubernetes Operator Guide: review, setup & limitations · Undominated.ai

> Infisical skill for running the Infisical Kubernetes Operator: syncing secrets into Kubernetes Secrets and ConfigMaps, pushing secrets back to Infisical, and managing dynamic secret leases in-cluster.

[← Explore all skills](/skills/)

CONTAINERS / Infisical Inc.

# Infisical Kubernetes Operator Guide

Infisical skill for running the Infisical Kubernetes Operator: syncing secrets into Kubernetes Secrets and ConfigMaps, pushing secrets back to Infisical, and managing dynamic secret leases in-cluster.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 7 linked sources
 Publisher Infisical Inc.
 Licence [MIT ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE)
 Revision d7e7fa443893
 [Read what was—and wasn’t—checked ↓](#review)

“Guide for the Infisical Kubernetes Operator — syncing secrets from Infisical into Kubernetes Secrets and ConfigMaps, pushing secrets from Kubernetes to Infisical, and managing dynamic secret leases in-cluster. Covers the v1beta1 CRDs (InfisicalConnection, InfisicalAuth, InfisicalStaticSecret) and the legacy v1alpha1 CRDs (InfisicalSecret, InfisicalDynamicSecret, InfisicalPushSecret), Helm installation cluster-wide or namespace-scoped, all 7 operator auth methods, sources and targets, creationPolicy Owner vs Orphan, refreshInterval, the secrets.infisical.com/auto-reload annotation for automatic Deployment rollouts, and Go templating of rendered secrets. Use this skill when someone asks about: Infisical Kubernetes Operator, InfisicalSecret CRD, InfisicalStaticSecret, syncing Infisical secrets into a Kubernetes Secret, auto-reloading pods on secret change, pushing Kubernetes secrets to Infisical, or 'how do I get Infisical secrets into my Kubernetes cluster'. Not for self-hosting Infisical on Kubernetes (infisical-self-host) — that is a different Helm chart — nor for rendering secrets to files (infisical-agent).”

 [Infisical Inc. · upstream description ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It makes the agent establish the CRD API version first: v1beta1 splits the work into InfisicalConnection, InfisicalAuth and InfisicalStaticSecret, while legacy v1alpha1 puts it all in one InfisicalSecret.
- It states that a synced Secret restarts nothing by itself and that dependent Deployments need the secrets.infisical.com/auto-reload: "true" annotation.

### A good fit for

 - Sync Infisical secrets into a Kubernetes Secret or ConfigMap with InfisicalStaticSecret
- Install the operator cluster-wide or namespace-scoped with Helm
- Authenticate the operator with method: kubernetes so no static credential is stored in the cluster
- Push secrets from Kubernetes to Infisical with InfisicalPushSecret

### Weigh up before choosing

 - The skill documents InfisicalDynamicSecret and InfisicalPushSecret only at v1alpha1, which it calls legacy and deprecating soon.
- In namespace-scoped installs only the first install may create the CRDs; later installs must set installCRDs: false.
- references/install-and-auth.md lists Kubernetes 1.33, 1.32, 1.31, 1.30 and 1.29 as officially supported; other versions may work but are not officially supported.
- Self-hosting Infisical on Kubernetes uses a different chart and is out of scope (infisical-self-host).
- skills/infisical-kubernetes-operator was last changed on 2026-08-12 (commit da9176b6) as of the reviewed pin d7e7fa44.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/infisical-kubernetes-operator/SKILL.md
- skills/infisical-kubernetes-operator/references/install-and-auth.md
- README.md
- LICENSE
- .claude-plugin/marketplace.json

### Our findings

 - It says creationPolicy Owner ties the managed Secret to the CRD and Orphan leaves it behind on delete, and defaults to Owner.
- It says never to put a client secret inline in a manifest; credentials go in a Kubernetes Secret that the CRD references.
- The operator chart is secrets-operator from the same Cloudsmith Helm repository that holds the self-hosting chart.
- It suggests External Secrets Operator, which has an Infisical provider, for users who already run it.

### Not established by this review

 - Not executed: it was not installed or run.
- No Helm chart was installed and no manifest was applied.
- references/install-and-auth.md was read only in part (supported versions, Helm install and the start of the auth sections); references/syncing-secrets.md and references/dynamic-and-push.md were not read.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md)
 - The README's universal install, npx skills add Infisical/ai-skills, names the whole Infisical/ai-skills repository, which the README says holds 17 skills; no file at the pin prints a line that installs infisical-kubernetes-operator alone.
- For Claude Code the README prints /plugin marketplace add Infisical/ai-skills. That adds the infisical-ai-skills marketplace, whose .claude-plugin/marketplace.json lists infisical-kubernetes-operator as its own plugin (source ./infisical-kubernetes-operator, plugin root ./plugins); no file at the pin prints the line that installs that plugin.
- For a manual install the README says to copy skill folders from skills/ into the agent's skills directory; for this skill that is skills/infisical-kubernetes-operator/, copied to .claude/skills/ (Claude Code), ~/.codex/skills/ (Codex), .cursor/skills/ or .agents/skills/ (Cursor), or .github/skills/ (GitHub Copilot).
- The README recommends Infisical's hosted docs MCP at https://infisical.com/docs/mcp ahead of the skills; that is a separate server and does not install infisical-kubernetes-operator.

### Before you start

 - Kubernetes 1.29 to 1.33 for official support
- Helm, with the chart repository https://dl.cloudsmith.io/public/infisical/helm-charts/helm/charts/

### Compatibility

skills CLI · Claude Code · Codex · Cursor · GitHub Copilot

### Guidance for a cluster controller that writes Secrets and ConfigMaps; no tools declared

 - Loads SKILL.md and, when needed, references/install-and-auth.md, references/syncing-secrets.md or references/dynamic-and-push.md; the frontmatter declares no allowed-tools and the directory holds Markdown only.
- The operator it installs keeps Kubernetes Secrets and ConfigMaps in step with Infisical, across all namespaces by default or limited with scopedNamespaces and scopedRBAC.
- InfisicalPushSecret sends secrets from the cluster to Infisical.
- The Helm install fetches the chart from dl.cloudsmith.io.

### Cost model

The skill is MIT-licensed, copyright 2026 Infisical Inc. SKILL.md states no Infisical plan or price for the operator.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [skills/infisical-kubernetes-operator/SKILL.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/SKILL.md) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/SKILL.md Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, access.label, access.permissions, install.prerequisites
- [skills/infisical-kubernetes-operator/references/install-and-auth.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/references/install-and-auth.md) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/references/install-and-auth.md Supports: limitations, install.prerequisites, access.permissions, review.findings
- [README.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md Supports: install.command, install.sourceUrl, install.steps, compatibility, summary
- [LICENSE at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE Supports: license, publisher, access.cost
- [.claude-plugin/marketplace.json at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json Supports: install.steps
- [skills/infisical-kubernetes-operator directory at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator) Checked 2026-10-21 https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator Supports: access.permissions, review.findings
- [Last commit touching skills/infisical-kubernetes-operator at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be) Checked 2026-10-21 https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be Supports: limitations

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Docker Build Strategies ↗ Teaches Docker BuildKit multi-stage builds, target execution, cache mount typing, and minimal distroless runtime patterns.](/skills/docker-docker-build-strategies/)[### Docker Compose Patterns ↗ Establishes production patterns for compose.yaml: strict healthcheck dependencies, curl sidecars for scratch images, and secret masking.](/skills/docker-docker-compose-patterns/)[### Docker Project Foundations ↗ Create the first Dockerfile, Compose stack and dockerignore with local-port and build-secret boundaries.](/skills/docker-project-foundations/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
