Skip to main content

Load Balancers

Distribute incoming traffic across multiple instances with managed load balancers.

Overview

Load balancers spread network traffic across backend servers to improve availability and fault tolerance. They support HTTP, HTTPS, TCP, and UDP protocols with Round Robin, Least Connections, or Source IP algorithms.


Step 1: Create a Load Balancer

  1. Navigate to Enterprise > Networking > Load Balancers
  2. Click Create Load Balancer
  3. Configure:
SettingDescription
Namee.g., lb-production-api
FlavorCompute size (vCPU, RAM) for the load balancer
Network typePrivate (select network + subnet) or Public
IP familyIPv4, IPv6, or Dual
Preferred connectivityL3 (default) or L2
Reserved IPOptional — assign a static VIP
TagsOptional — key-value metadata
  1. Review the estimated cost in the sidebar and click Create Load Balancer

Create Load Balancer


Step 2: Manage Load Balancers

From the load balancer list, use the three-dot menu to:

  • Overview — View general info, statistics (connections, bytes, errors), and resize the flavor
  • Rename — Update the load balancer name
  • Delete — Remove the load balancer

To resize, open Overview > Change Configuration, select a new flavor, and click Save.

Load Balancers List


Step 3: Create a Listener

Listeners define how the load balancer receives traffic.

  1. Select a load balancer in the Listener Creation section
  2. Click Create Listener
  3. Configure:
SettingDescription
Namee.g., http-web
ProtocolHTTP, HTTPS, TCP, or UDP
Port1–65535
Connection limitMax connections (-1 for unlimited)
Allowed CIDRsIP allowlist (optional)
X-Forwarded headersHTTP only — adds forwarding headers
TLS certificateTERMINATED_HTTPS only
User listHTTP only — basic auth users

Use the three-dot menu on a listener to Edit, Delete, or Add pool.


Step 4: Add a Pool

A pool defines the backend servers that receive traffic from a listener.

  1. Click the three-dot menu on a listener and select Add pool
  2. Configure:
SettingDescription
Pool namee.g., backend-pool
AlgorithmRound Robin, Least Connection, or Source IP
ProtocolHTTP, HTTPS, TCP, UDP, PROXY, or PROXYV2
  1. Add members (Instance, Baremetal, or Custom IP) with port and weight
  2. Optionally enable Health check (HTTP, HTTPS, PING, TCP, or TLS-HELLO) with interval and threshold settings
  3. Click Save

Click a listener card to view Listener Details — pool overview, member table, and health check status. Use Edit or Delete from there to manage the pool.

Listener Details


Troubleshooting

ProblemSolution
Stuck in PENDING_CREATECheck Tasks page and quota limits
502 Bad GatewayVerify backend health and health check config
No traffic reaching backendsCheck listener protocol, port, and allowed CIDRs
Pool member OFFLINEEnsure member is running and health endpoint reachable
Cannot resizeSelect a different flavor than the current one

this is the docs add it and add the route in the sidebars.ts I have added the image