---
title: "ezgh hosted-queues clusters create"
description: "Create a cluster."
---

> 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 hosted-queues clusters 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 hosted-queues clusters create <name> --engine e --engine-version v --instance-type t --storage-size-gib n --subnet s [flags] [--wait]
```

Create a cluster in a subnet of your VPC. `ezgh hosted-queues clusters engine-versions` lists the engines (kafka, rabbitmq) and versions. `--mode` single (the default) is one node; `--mode` replicated is three that keep serving through the loss of any one, and needs a gp-1 or gs-1 instance type. The subnet needs 2 free addresses, 4 when replicated. The app user's password is written to a new Secret in the project, which `ezgh hosted-queues users get <cluster> app` names. RabbitMQ's new queues are quorum queues unless the app declares another type; Celery 5.5 and later needs task_default_queue_type = "quorum". It takes minutes: `--wait` waits until it's available and prints it.

Part of [`ezgh hosted-queues clusters`](/cli/reference/hosted-queues-clusters).

## Examples

```sh
ezgh hosted-queues clusters create events --engine kafka --engine-version 4.4 --mode replicated \
  --instance-type gp-1.large --storage-size-gib 100 --subnet sbn_2m9x0a7qpe4k --wait
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--allowed-source-cidr` | string, repeatable |  | an IPv4 CIDR that may connect; repeat for more, at most 20 (default the VPC's ranges) |
| `--deletion-protection` | boolean |  | refuse deletes until it's turned off |
| `--description` | string |  | what it's for |
| `--engine` | string |  | kafka or rabbitmq |
| `--engine-version` | string |  | the engine's version, from ezgh hosted-queues clusters engine-versions |
| `--instance-type` | string |  | a gp-1, gs-1 or (single node only) hp-1 instance type |
| `--maintenance-window` | string |  | when maintenance happens, ddd:HH:MM-ddd:HH:MM UTC, at least 30 minutes |
| `--mode` | string |  | single or replicated (default single) |
| `--plaintext-port` | boolean |  | also serve password over plaintext inside the VPC (Kafka 9092, RabbitMQ 5672) |
| `--storage-size-gib` | int |  | each node's storage, in GiB (at least 10) |
| `--subnet` | string |  | the subnet it's in (sbn\_…) |
| `--tag` | string, repeatable |  | a tag, key=value; repeat for more |
| `--unauthenticated-access` | string |  | Kafka only: also serve TLS port 9091 with no authentication, readWrite or readOnly |
| `--wait` | boolean |  | wait until it's available, and print it then |
| `--wait-timeout` | duration | `10m0s` | how long `--wait` waits |

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

Source: https://docs.ezghcloud.com/cli/reference/hosted-queues-clusters-create/index.mdx
