Terminal
Terminal/Skill
Covers deploying self-hosted Infisical with Docker, Docker Compose or Kubernetes, including ENCRYPTION_KEY handling, PostgreSQL, Redis and scaling.
By Infisical
Works with
npx skills add infisical/ai-skills --skill infisical-self-hostThis skill guides you through deploying, configuring, and operating Infisical in self-hosted environments. Whether you are running Infisical on Docker, Docker Compose, or Kubernetes, this resource covers essential setup, security hardening, scaling, and maintenance patterns.
| If the user wants... | Use |
|---|---|
| To deploy the Kubernetes Operator (also a Helm chart, different thing) | infisical-kubernetes-operator |
| To reach a private resource from Infisical | infisical-gateway |
| To configure SSO or SCIM on their instance | infisical-sso |
| Roles, permissions, audit log streams | infisical-access-control |
| To use Infisical once it is running | infisical-setup |
| An external KMS or HSM backing the root key | infisical-kms |
The Helm confusion is worth pre-empting: the secrets-operator chart installs the operator;
this skill covers the chart that installs the platform. Both come from the same Cloudsmith repo.
ENCRYPTION_KEY is Critical: This key encrypts all secrets at rest and cannot be recovered if lost. Back it up and rotate it carefully following Infisical's rotation procedures.
openssl rand -hex 16openssl rand -base64 32AUTH_SECRET is Required: This key is used for session and JWT signing. It is 32 bytes (base64), generated with openssl rand -base64 32, and must be stable across restarts.
Database Requirements: PostgreSQL is the only supported database. Use 14+ for compatibility; Infisical is extensively tested on 16. Always backup your database before upgrading Infisical. Schema migrations run automatically on boot (since v0.111.0-postgres).
Redis is a hard dependency, not just a cache: Beyond caching it holds the background job queue, distributed locks, cross-instance coordination state, and rate-limit counters. The instance will not start unless one of REDIS_URL, REDIS_SENTINEL_HOSTS, or REDIS_CLUSTER_HOSTS is set, and a running instance is degraded while Redis is unreachable.
noeviction. This is required, not a tuning suggestion — evicting keys under memory pressure would silently drop queued workStateless Architecture: Infisical is stateless. Scale horizontally by adding more replicas. All state lives in PostgreSQL and Redis. Each instance needs no more than 2–4 CPU cores and 4–8 GB memory; add containers rather than growing one.
FIPS Compliance: Infisical is compliant with FIPS 140-3. Deploy the separate infisical/infisical-fips Docker image (an Enterprise-only image, not a tag on the standard repo) and set FIPS_ENABLED=true. Remember the ENCRYPTION_KEY format changes to 256-bit base64 in FIPS mode.
infisical/infisical:<version>, set environment variables, run on port 8080.docker-compose.prod.yml from the repository with PostgreSQL and Redis services.infisical-standalone-postgres from Cloudsmith registry with optional managed databases.Complete reference for all configuration environment variables, including:
Docker and Docker Compose deployment patterns, including:
Kubernetes and Helm deployment guide, including:
Production scaling patterns and HA architecture, including: