← Explore all skills

INFRASTRUCTURE / Infisical Inc.

Infisical Self-Hosted Deployment

Infisical skill for deploying and running a self-hosted Infisical instance with Docker, Docker Compose or the Kubernetes Helm chart, including its PostgreSQL and Redis dependencies.

“Deploy and operate Infisical self-hosted instances with Docker, Docker Compose, and Kubernetes. Covers architecture, environment variables, ENCRYPTION_KEY management, PostgreSQL setup, Redis configuration (including the required noeviction policy), production hardening, FIPS 140-3 compliance, scaling, and high availability patterns. For deploying the Infisical platform itself. Not for the Kubernetes Operator, which is a separate Helm chart (infisical-kubernetes-operator), nor for using Infisical once running (infisical-setup).”

01 / THE REASONING

Why this made the selection.

  • It states that ENCRYPTION_KEY cannot be recovered if lost and gives its format: openssl rand -hex 16 for standard deployments, a 256-bit base64 key from openssl rand -base64 32 with FIPS.
  • It treats Redis as a hard dependency: the instance will not start unless REDIS_URL, REDIS_SENTINEL_HOSTS or REDIS_CLUSTER_HOSTS is set, and the eviction policy must be noeviction.

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-self-host/SKILL.md
  • README.md
  • LICENSE
  • .claude-plugin/marketplace.json

Our findings

  • It says schema migrations run automatically on boot (since v0.111.0-postgres) and to back up the database before upgrading.
  • It sizes each instance at no more than 2–4 CPU cores and 4–8 GB memory and says to add containers rather than grow one.
  • It says to enable Redis persistence because pending secret rotations, syncs and webhook deliveries live there.

Not established by this review

  • Not executed: it was not installed or run.
  • No container, Compose stack or Helm release was started.
  • references/environment-variables.md, references/docker-deployment.md, references/kubernetes-deployment.md and references/scaling-and-ha.md were not read beyond a search for plan and tier wording.

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 ↗
  1. 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-self-host alone.
  2. 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-self-host as its own plugin (source ./infisical-self-host, plugin root ./plugins); no file at the pin prints the line that installs that plugin.
  3. 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-self-host/, copied to .claude/skills/ (Claude Code), ~/.codex/skills/ (Codex), .cursor/skills/ or .agents/skills/ (Cursor), or .github/skills/ (GitHub Copilot).
  4. 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-self-host.

Before you start

  • PostgreSQL 14+
  • Redis 6.x or 7.x (at least 6.2 advised) with the eviction policy set to noeviction
  • Docker, Docker Compose, or Kubernetes with Helm

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-self-host/SKILL.md

    Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, access.label, access.permissions, install.prerequisites

  2. README.md at d7e7fa44 ↗Checked

    https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md

    Supports: install.command, install.sourceUrl, install.steps, compatibility, summary

  3. LICENSE at d7e7fa44 ↗Checked

    https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE

    Supports: license, publisher, access.cost

  4. https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json

    Supports: install.steps

  5. https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-self-host

    Supports: access.permissions, review.findings

  6. https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be

    Supports: limitations

Evidence & Ask