Skip to main content

Documentation Index

Fetch the complete documentation index at: https://infisical.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Gateway Pools provide high availability for your gateway infrastructure. A pool is a named collection of gateways that all have connectivity to the same private network. When the platform needs to reach a resource through a pool, it automatically routes through a healthy gateway, providing failover if any individual gateway goes down.
Gateway Pools is an enterprise feature. Self-hosted users can contact sales@infisical.com to purchase an enterprise license.

​
How It Works

  1. You create a Gateway Pool and add multiple gateways that share network access to the same resources.
  2. When configuring a consumer (e.g., Kubernetes Auth), you select the pool instead of an individual gateway.
  3. At request time, the platform picks a random healthy gateway from the pool and routes through it.
  4. If a gateway goes down, subsequent requests automatically route through the remaining healthy gateways.
A gateway is considered healthy if it has sent a heartbeat within the last hour and its last health check did not fail.

​
Creating a Gateway Pool

  1. Navigate to Organization Settings > Networking > Gateways.
  2. Click the Gateway Pools tab.
Gateway Pools Switch
  1. Click Create Pool.
Gateway Pools Tab
  1. Enter a name for the pool and click Create Pool.
Create Gateway Pool

​
Adding Gateways to a Pool

  1. In the Gateway Pools tab, click on a pool to open its detail view.
Click on a pool
  1. Click Add Gateway and select a gateway from the dropdown.
Add gateway to pool
  1. Repeat for each gateway you want to add.
A gateway can belong to multiple pools if it has connectivity to resources served by each pool. Pool membership can be changed at any time without restarting the gateway.

​
Using a Pool in a Consumer Config

Anywhere you configure a gateway, the gateway picker dropdown shows both individual gateways and gateway pools. Pools are listed under the “Gateway Pools” section with an HA (high availability) badge and health status. When you select a pool, the platform validates connectivity through one of its healthy gateways before saving.

​
Gateway Selection

When a request is routed through a pool, the platform picks a gateway at random from the pool’s healthy gateways. There is no round-robin or weighted selection.

​
Pool Health

Each pool displays an aggregate health status based on its gateways:
  • Green (e.g., “3/3 healthy”) - All gateways are healthy
  • Yellow (e.g., “2/3 healthy”) - Some gateways are unhealthy
  • Red (e.g., “0/3 healthy”) - All gateways are unhealthy
If all gateways in a pool are unhealthy when a request is made, the request fails with a descriptive error.

​
FAQ

No. A pool cannot be deleted if it is referenced by any consumer configurations (e.g., Kubernetes Auth). You must first update those configurations to use a different gateway or pool before deleting.
Each pool shows a count of connected consumer configurations in the table. Click the count to see the full list with links to each resource.
The request fails with a descriptive error. You should ensure at least one gateway in the pool is online and has a recent heartbeat.
Yes. A gateway can belong to as many pools as needed, as long as it has connectivity to the resources served by each pool.