Skip to content

Infisical is the open-source platform for securing secrets, certificates, access, and AI Agents.

docs(gateways): stop describing the gateway as a credential broker

bernie-gc187f5db7292
diff --git a/docs/cli/commands/gateway.mdx b/docs/cli/commands/gateway.mdx
index 7432011467..79a9361d2a 100644
--- a/docs/cli/commands/gateway.mdx
+++ b/docs/cli/commands/gateway.mdx
@@ -18,7 +18,7 @@ description: "Run the Infisical gateway or manage its systemd service"
## Description
-The Infisical gateway gives the platform access to resources in your private network without handing out their credentials.
+The Infisical gateway runs inside your network and lets Infisical reach systems that aren't exposed to the internet, such as a database in a private subnet or an on-premises appliance.
There are two ways the gateway and Infisical reach each other:
@@ -31,7 +31,7 @@ Passing `--listen-address` and `--relay` together runs both, and Infisical uses
<AccordionGroup>
<Accordion title="infisical gateway start" defaultOpen="true">
- Run the Infisical gateway component within your the network where your target resources are located. The gateway establishes an SSH reverse tunnel to a relay server and provides secure access to private resources within your network.
+ Run the gateway inside the network where your target resources live. It connects to Infisical over a relay or by listening for direct connections, depending on the flags below.
```bash
infisical gateway start <gateway-name> --enroll-method=token --token=<enrollment-token> --domain=<domain>
diff --git a/docs/documentation/platform/gateways/overview.mdx b/docs/documentation/platform/gateways/overview.mdx
index 81c750da8b..03c7850235 100644
--- a/docs/documentation/platform/gateways/overview.mdx
+++ b/docs/documentation/platform/gateways/overview.mdx
@@ -27,7 +27,7 @@ If the target is already reachable and you would rather not run a gateway, you c
## How it works
-The gateway system uses SSH reverse tunnels, so connectivity works without changing inbound firewall rules:
+In relay mode the gateway uses an SSH reverse tunnel, so connectivity works without changing inbound firewall rules. In [direct listen mode](/documentation/platform/gateways/network-architecture#direct-listen-mode) Infisical connects to the gateway instead, and the steps below don't apply:
![Architecture Overview](../../../images/platform/gateways/gateway-highlevel-diagram.png)