---
title: Charmhub | Deploy Kubeapi Load Balancer using Charmhub - The Open Operator
  Collection
description: Deploy the latest version of Kubeapi Load Balancer on any cloud.
url: https://charmhub.io/kubeapi-load-balancer/configurations
---

# Kubeapi Load Balancer

[Canonical Kubernetes](https://charmhub.io/publisher/containers "View all packages from Canonical Kubernetes")

* [Canonical Kubernetes](https://charmhub.io/publisher/containers "View all packages from Canonical Kubernetes")

Platform:

24.04

22.04

20.04

18.04

16.04

stable 8655d67

```
juju deploy kubeapi-load-balancer
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [extra\_sans](https://charmhub.io/kubeapi-load-balancer/configurations#extra_sans)
* [ha-cluster-dns](https://charmhub.io/kubeapi-load-balancer/configurations#ha-cluster-dns)
* [ha-cluster-vip](https://charmhub.io/kubeapi-load-balancer/configurations#ha-cluster-vip)
* [loadbalancer-ips](https://charmhub.io/kubeapi-load-balancer/configurations#loadbalancer-ips)
* [nginx-events-config](https://charmhub.io/kubeapi-load-balancer/configurations#nginx-events-config)
* [nginx-http-config](https://charmhub.io/kubeapi-load-balancer/configurations#nginx-http-config)
* [nginx-main-config](https://charmhub.io/kubeapi-load-balancer/configurations#nginx-main-config)
* [proxy\_read\_timeout](https://charmhub.io/kubeapi-load-balancer/configurations#proxy_read_timeout)

[Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration)

* extra\_sans | string

  A space-separated list of additional Subject Alternative Names (SAN) entries
  to include in the x509 certificate created for the load balancers.
* ha-cluster-dns | string

  This option specifies the DNS entry to be used in conjunction with the HA Cluster
  subordinate charm. This option is mutually exclusive with the `ha-cluster-vip`
  option.
* ha-cluster-vip | string

  A space-separated list of virtual IPs that the charm can utilize in conjunction with the
  HA Cluster subordinate charm. This option is mutually exclusive with the `ha-cluster-dns`
  option.
* loadbalancer-ips | string

  A space-separated list of IP addresses of load balancers in front of the control plane.
  A common use case for this is having virtual IP addresses floated in front of the
  kubeapi-load-balancer charm. The workers will evenly distribute the load by alternating
  between the IP addresses in this list. For example, if you have 2 IPs and 4 workers,
  each IP will be used by 2 workers.
* nginx-events-config | string

  This option allows the juju operator to configure directives inside the nginx events
  context in /etc/nginx/nginx.conf. Provide a valid block of YAML. For instance:

  ```
    worker_connections: 512
    accept_mutex: "on"
  ```

  The directives specified here modify how Nginx handles connections in general. For
  detailed information about these directives, refer to the upstream documentation:
  https://nginx.org/en/docs/
* nginx-http-config | string

  This option allows the juju operator to configure directives in the http context block
  of /etc/nginx/nginx.conf. Provide a valid block of YAML. For instance:

  ```
    client_max_body_size: 3m
    connection_pool_size: 256
  ```

  The directives specified here modify how Nginx handles HTTP or HTTPS connections. For
  detailed information about these directives, refer to the upstream documentation:
  https://nginx.org/en/docs/
* nginx-main-config | string

  This option allows the juju operator to configure directives in the main context block
  of /etc/nginx/nginx.conf. Provide a valid block of YAML. For instance:

  ```
    worker_rlimit_nofile: 1024
    worker_processes: "auto"
  ```

  The directives specified here have a broad impact on the entire NGINX configuration. For
  detailed information about these directives, refer to the upstream documentation:
  https://nginx.org/en/docs/
* proxy\_read\_timeout | int

  Default: 600

  The timeout in seconds for reading a response from proxy server.