INFRASTRUCTURE / Infisical Inc.
Infisical Gateway Guide
Infisical skill for deploying the Infisical Gateway and relays so that Infisical can reach private databases, directories, APIs and HSMs over outbound-only SSH reverse tunnels.
“Guide for the Infisical Gateway and Relay — reaching private network resources (VPC-only databases, on-premises directories, internal APIs, HSMs) from Infisical without any inbound firewall rules. Covers the gateway/relay architecture using SSH reverse tunnels, exact ports and egress allowlist requirements (TCP 2222 to the relay, TCP 443 to Infisical, TCP 8443 platform-to-relay), deployment with `infisical gateway start` and `infisical gateway systemd`, Infisical-managed vs self-deployed relays, Gateway Pools for high availability, health checks and heartbeat intervals, and which features and App Connection types can be routed through a gateway. Use this skill when someone asks about: Infisical Gateway, relay server, accessing a private database from Infisical, dynamic secrets for a database with no public endpoint, gateway pools, or 'Infisical cannot reach my internal resource'. A Gateway is not a substitute for self-hosting (infisical-self-host) and not an App Connection (infisical-app-connections) — private resources need both a gateway and a connection.”
01 / THE REASONING
Why this made the selection.
- It names the exact egress the gateway needs: TCP 2222 to the relay, TCP 443 to Infisical, and TCP 8443 platform-to-relay.
- It corrects two misconceptions: that one gateway can cover several isolated networks, which it calls the most common design mistake, and that reaching private resources requires self-hosting Infisical.
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-gateway/SKILL.md
- skills/infisical-gateway/references/pools-and-consumers.md
- README.md
- LICENSE
- .claude-plugin/marketplace.json
Our findings
- It says traffic through the relay is double-encrypted and the relay routes it without being able to decrypt it.
- It says gateways report health every 3 minutes and relays hourly.
- It tells the agent to check egress before debugging anything else, and says no inbound ports are ever needed.
Not established by this review
- Not executed: it was not installed or run.
- No gateway or relay was deployed and no port was checked.
- references/deployment-and-networking.md was not read; references/pools-and-consumers.md was read only for its opening section.
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.
- 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-gateway 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-gateway as its own plugin (source ./infisical-gateway, 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-gateway/, 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-gateway.
Before you start
- An Infisical Enterprise plan (Gateway is a paid Enterprise feature)
- Outbound TCP 2222 to the relay and TCP 443 to Infisical from the gateway host
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway/SKILL.md
Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, access.label, access.permissions, install.prerequisites
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway/references/pools-and-consumers.md
Supports: limitations, access.cost
- README.md at d7e7fa44 ↗Checked
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md
Supports: install.command, install.sourceUrl, install.steps, compatibility, summary
- LICENSE at d7e7fa44 ↗Checked
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE
Supports: license, publisher, access.cost
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json
Supports: install.steps
https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway
Supports: access.permissions, review.findings
https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be
Supports: limitations