---
title: "Infisical Gateway Guide: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/infisical-gateway/
description: "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."
---

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

> 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.

[← Explore all skills](/skills/)

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.

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

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 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.”

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

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.

### A good fit for

 - Let Infisical Cloud reach a VPC-only database without opening inbound firewall rules
- Plan one gateway per isolated network
- Deploy a gateway with infisical gateway start or infisical gateway systemd
- Group gateways into a Gateway Pool for high availability

### Weigh up before choosing

 - Gateway is a paid Enterprise feature, and Gateway Pools are an Enterprise feature too.
- Only 16 App Connection types accept a gateway, and gatewayId and gatewayPoolId cannot both be set.
- A gateway provides the network path only; a private resource still needs an App Connection for the credentials.
- skills/infisical-gateway 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-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.

[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-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

### Compatibility

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

### Guidance for running an outbound-only tunnel into a private network; no tools declared

 - Loads SKILL.md and, when needed, references/deployment-and-networking.md or references/pools-and-consumers.md; the frontmatter declares no allowed-tools and the directory holds Markdown only.
- A gateway it helps deploy runs inside the user's network, holds an outbound SSH reverse tunnel to a relay using SSH certificates issued by Infisical, and connects to private resources on Infisical's behalf.
- Ports named: TCP 2222 to the relay and TCP 443 to Infisical from the gateway, TCP 8443 from the platform to the relay.

### Cost model

The skill is MIT-licensed, copyright 2026 Infisical Inc. Gateway is a paid Enterprise feature, and so are Gateway Pools.

04 / FOLLOW THE EVIDENCE

## The source trail.

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

 - [skills/infisical-gateway/SKILL.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway/SKILL.md) Checked 2026-10-21 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
- [skills/infisical-gateway/references/pools-and-consumers.md at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway/references/pools-and-consumers.md) Checked 2026-10-21 https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway/references/pools-and-consumers.md Supports: limitations, access.cost
- [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-gateway directory at d7e7fa44 ↗](https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway) Checked 2026-10-21 https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-gateway Supports: access.permissions, review.findings
- [Last commit touching skills/infisical-gateway 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.

 [### 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.](/skills/infisical-self-host/)[### Azure Verified Module Review ↗ Review Terraform module structure against the pinned AVM requirements guide.](/skills/hashicorp-azure-verified-modules/)[### Packer Azure Image Builder ↗ Prepare Azure managed or Compute Gallery images with Packer.](/skills/hashicorp-azure-image-builder/)

 [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/)
