---
title: "ezgh lb target-groups create"
description: "Create a target group."
---

> 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 target-groups 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 target-groups create <name> --vpc <vpc_…> --port p [--proxy-protocol none|v2] [--health-check-…] [--tag k=v…] [flags]
```

Create a target group in a VPC. Without health check flags it checks a TCP connection to each target every 5 seconds. With `--proxy-protocol` v2 targets get the client's address; a target that doesn't speak it fails.

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

## Examples

```sh
ezgh lb target-groups create web --vpc vpc_5p7r9s3t1vxz --port 8080
ezgh lb target-groups create api --vpc vpc_5p7r9s3t1vxz --port 9000 --health-check-protocol http --health-check-path /healthz
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--deregistration-delay` | int |  | seconds a deregistered target's connections may finish in, 0 to 3600 (default 300) |
| `--description` | string |  | what it's for |
| `--health-check-interval` | int |  | seconds between checks, 2 to 300 (default 5) |
| `--health-check-matcher` | string |  | an http or https check's healthy status codes (default 200-399) |
| `--health-check-path` | string |  | an http or https check's path (default /) |
| `--health-check-port` | int |  | the port checks use (default the target's) |
| `--health-check-protocol` | string |  | tcp, http or https (default tcp) |
| `--health-check-timeout` | int |  | seconds a check may take, 1 to 120, below the interval (default 2) |
| `--healthy-threshold` | int |  | passed checks before a target is healthy, 1 to 10 (default 3) |
| `--port` | int |  | the targets' port, 1 to 65535 |
| `--protocol` | string |  | tcp, for tcp and tls listeners, or http, for http and https listeners, with an http health check (default tcp) |
| `--proxy-protocol` | string |  | none or v2: v2 passes the client's address to targets that speak it (default none) |
| `--run-service` | string |  | a Run service in the project (rsv\_…) its requests go to, as its URL's do: it takes no targets, is http, and its port, health check and deregistration delay are fixed; for http and https listeners (needs run.services.invoke on the service) |
| `--tag` | string, repeatable |  | a tag, key=value; repeat for more |
| `--unhealthy-threshold` | int |  | failed checks before a target is unhealthy, 1 to 10 (default 2) |
| `--vpc` | string |  | its VPC (vpc\_…) |

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

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