---
id: "load-balancer"
type: "kind"
category: "edge"
url: "https://localhost:3000/catalogue/kinds/load-balancer"
---

# Load balancer

Spreads connections or requests across backends.

| | |
|---|---|
| Category | Edge |
| Properties | 7 |
| Components | 35 |
| Rules | 0 |

## Properties

| property | type | values | required | default |
|---|---|---|---|---|
| `connectionPreserving` (advanced) | boolean | — | no | false |
| `global` | boolean | — | no | false |
| `hashing` | enum | `round-robin`, `least-connections`, `ecmp`, `maglev`, `consistent`, `random` | no | "round-robin" |
| `healthChecks` | boolean | — | no | true |
| `instances` | integer | — | no | — |
| `layer` | enum | `l4`, `l7` | no | "l7" |
| `managed` | boolean | — | no | false |

## Rules for this kind · 0

No rule selects this kind or its category.

## Components · 35

### vendor-neutral

- [Generic load balancer](https://localhost:3000/catalogue/components/load-balancer.md) `load-balancer` — the kind itself

### alibabacloud

- [Server Load Balancer](https://localhost:3000/catalogue/components/alibaba-slb.md) `alibaba-slb` — 2 defaults

### aws

- [AWS Application Load Balancer](https://localhost:3000/catalogue/components/alb.md) `alb` — 4 defaults
- [AWS Classic Load Balancer](https://localhost:3000/catalogue/components/aws-classic-load-balancer.md) `aws-classic-load-balancer` — 5 defaults
- [AWS Global Accelerator](https://localhost:3000/catalogue/components/aws-global-accelerator.md) `aws-global-accelerator` — 5 defaults
- [AWS Gateway Load Balancer](https://localhost:3000/catalogue/components/aws-gwlb.md) `aws-gwlb` — 6 defaults
- [AWS Network Load Balancer](https://localhost:3000/catalogue/components/nlb.md) `nlb` — 4 defaults

### azure

- [Azure Application Gateway](https://localhost:3000/catalogue/components/azure-application-gateway.md) `azure-application-gateway` — 2 defaults
- [Application Gateway for Containers](https://localhost:3000/catalogue/components/azure-application-gateway-for-containers.md) `azure-application-gateway-for-containers` — 3 defaults
- [Azure Load Balancer](https://localhost:3000/catalogue/components/azure-load-balancer.md) `azure-load-balancer` — 3 defaults

### cloudflare

- [Cloudflare Load Balancing](https://localhost:3000/catalogue/components/cloudflare-load-balancing.md) `cloudflare-load-balancing` — 4 defaults
- [Cloudflare Spectrum](https://localhost:3000/catalogue/components/cloudflare-spectrum.md) `cloudflare-spectrum` — 4 defaults

### default

- [Apache HTTP Server](https://localhost:3000/catalogue/components/apache-httpd.md) `apache-httpd` — 4 defaults
- [BFE](https://localhost:3000/catalogue/components/bfe.md) `bfe` — 5 defaults
- [Caddy](https://localhost:3000/catalogue/components/caddy.md) `caddy` — 4 defaults
- [Contour](https://localhost:3000/catalogue/components/contour.md) `contour` — 4 defaults
- [Envoy](https://localhost:3000/catalogue/components/envoy.md) `envoy` — 4 defaults
- [F5 BIG-IP](https://localhost:3000/catalogue/components/f5-big-ip.md) `f5-big-ip` — 2 defaults
- [HAProxy](https://localhost:3000/catalogue/components/haproxy.md) `haproxy` — 4 defaults
- [Keepalived](https://localhost:3000/catalogue/components/keepalived.md) `keepalived` — 3 defaults
- [Load balancer](https://localhost:3000/catalogue/components/load-balancer-tier.md) `load-balancer-tier` — 1 defaults
- [loxilb](https://localhost:3000/catalogue/components/loxilb.md) `loxilb` — 5 defaults
- [MetalLB](https://localhost:3000/catalogue/components/metallb.md) `metallb` — 3 defaults
- [NGINX](https://localhost:3000/catalogue/components/nginx.md) `nginx` — 3 defaults
- [Traefik](https://localhost:3000/catalogue/components/traefik.md) `traefik` — 3 defaults

### digitalocean

- [DigitalOcean Load Balancers](https://localhost:3000/catalogue/components/digitalocean-load-balancer.md) `digitalocean-load-balancer` — 4 defaults

### gcp

- [Google Cloud Load Balancing](https://localhost:3000/catalogue/components/google-cloud-load-balancing.md) `google-cloud-load-balancing` — 4 defaults

### ibm

- [IBM Cloud Load Balancer for VPC](https://localhost:3000/catalogue/components/ibm-load-balancer.md) `ibm-load-balancer` — 4 defaults

### k8s

- [Kubernetes Gateway](https://localhost:3000/catalogue/components/k8s-gateway.md) `k8s-gateway` — 3 defaults
- [Ingress](https://localhost:3000/catalogue/components/k8s-ingress.md) `k8s-ingress` — 3 defaults
- [Service](https://localhost:3000/catalogue/components/k8s-service.md) `k8s-service` — 4 defaults

### oci

- [OCI Load Balancer](https://localhost:3000/catalogue/components/oci-load-balancer.md) `oci-load-balancer` — 4 defaults
- [Network Load Balancer](https://localhost:3000/catalogue/components/oci-network-load-balancer.md) `oci-network-load-balancer` — 5 defaults

### openstack

- [OpenStack Octavia](https://localhost:3000/catalogue/components/openstack-octavia.md) `openstack-octavia` — 2 defaults

### outscale

- [Load Balancer Unit (LBU)](https://localhost:3000/catalogue/components/outscale-lbu.md) `outscale-lbu` — 3 defaults

## Source (`kind` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../schema/kind.schema.json
# Abstract kind: Spreads connections or requests across backends at layer 4 or 7 (ELB, NGINX, HAProxy, Envoy, Unimog).
schemaVersion: "1"
type: "kind"
id: "load-balancer"
category: "edge"
properties:
  layer:
    type: "enum"
    values: ["l4", "l7"]
    default: "l7"
  hashing:
    type: "enum"
    values: ["round-robin", "least-connections", "ecmp", "maglev", "consistent", "random"]
    default: "round-robin"
  connectionPreserving:
    type: "boolean"
    default: false
    advanced: true
  healthChecks:
    type: "boolean"
    default: true
  global:
    type: "boolean"
    default: false
  instances:
    type: "integer"
  managed:
    type: "boolean"
    default: false
```

Human page: https://localhost:3000/catalogue/kinds/load-balancer