---
title: "ezgh lb listeners create"
description: "Add a listener."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh lb listeners create

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh lb listeners create <load-balancer> --protocol tcp|tls|http|https --port p --target-group <tgp_…> [--certificate <crt_…>] [--allowed-source-cidr c…] [--idle-timeout s] [flags]
```

Add a listener: a port on the load balancer that sends connections to a target group. A target group serves one load balancer, in its VPC. A tls or https listener needs `--certificate`, an issued certificate, and ends TLS with TLS 1.2 or 1.3; `--additional-certificate` adds more, served to clients asking by SNI for a name they cover. `--allowed-source-cidr` limits who may connect; without it, anyone can.

An http or https listener routes each request: its rules (`--rules-file`) are checked in order, and its default action takes what none matches: forward to a target group (`--target-group`, or `--forward` to split by weight), redirect to HTTPS (`--redirect-https`) or answer with a status code (`--fixed-response`). It forwards to http target groups. A rule's forward can also change the request's headers on the way in and the response's on the way out: requestHeaderModifier and responseHeaderModifier, each removing, setting and adding headers.

Part of [`ezgh lb listeners`](/cli/reference/lb-listeners).

## Examples

```sh
ezgh lb listeners create lbr_4k2m9x0a7qpe --protocol tls --port 443 --target-group tgp_7t3n1v8c2wzd --certificate crt_8s4f2k9d1mzq
ezgh lb listeners create lbr_4k2m9x0a7qpe --protocol tcp --port 5432 --target-group tgp_7t3n1v8c2wzd --allowed-source-cidr 203.0.113.0/24
ezgh lb listeners create lbr_4k2m9x0a7qpe --protocol https --port 443 --forward tgp_7t3n1v8c2wzd=90 --forward tgp_2b6d8f0h4jkm=10 --certificate crt_8s4f2k9d1mzq
ezgh lb listeners create lbr_4k2m9x0a7qpe --protocol http --port 80 --redirect-https
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--additional-certificate` | string, repeatable |  | another certificate (crt\_…) for a tls or https listener, served to clients asking by SNI for a name it covers; repeat for more, at most 24 |
| `--allowed-source-cidr` | string, repeatable |  | an IPv4 or IPv6 CIDR that may connect; repeat for more, at most 20 (default everyone, on each family the load balancer answers on) |
| `--certificate` | string |  | a tls or https listener's certificate (crt\_…) |
| `--fixed-response` | int |  | an http listener's default action: answer with this status code, 200 to 599 |
| `--forward` | string, repeatable |  | an http listener's default action: forward to a target group (tgp\_…); repeat with weights, tgp\_…=90, to split |
| `--idle-timeout` | int |  | seconds a connection may sit idle: tcp and tls 60 to 6000 (default 350), http and https 1 to 4000 (default 60) |
| `--port` | int |  | the port it listens on, 1 to 65535 |
| `--protocol` | string |  | tcp, tls, http or https |
| `--redirect-https` | boolean |  | an http listener's default action: redirect to HTTPS on port 443, keeping the host, path and query (301) |
| `--rules-file` | string |  | an http listener's rules, in order: rules as JSON (a list, or a listener with rules), - for stdin |
| `--target-group` | string |  | where it sends connections (tgp\_…) |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/lb-listeners-create/index.mdx
