---
title: "ezgh kubernetes 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 kubernetes 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 kubernetes clusters create <name> --subnet s --bot b [flags] [--wait]
```

Create a cluster in a subnet of your VPC. The VPC needs a Network Gateway, and the subnet's route table must send 0.0.0.0/0 to it. `--bot` is the cluster bot: load balancers, volumes and node capacity the cluster creates in this project are made as it, so it needs KubernetesClusterAccess, and you need bots.pass on it. You get cluster admin access unless `--no-creator-access`. It takes about 15 minutes: `--wait` waits until it's active and prints it.

`--logging-type` sends control-plane logs to the Obs project `--logging-project` names by its ID (prj\_…), billed as log ingest in that project, under service ezgh.kubernetes with attribute kubernetes.log_type:

```text
api                the API server's logs
audit              the API server's audit log
authenticator      one entry per sign-in with an EZGH cluster token or a node's instance identity:
                   time, credential type, whether it was authenticated, username, uid, groups and
                   error; never the token
controllerManager  the controller manager's logs
scheduler          the scheduler's logs
```

`--control-plane-metrics` sends the API server's, etcd's, the scheduler's and the controller manager's metrics once a minute to the cluster's project in Obs, production environment, free.

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

## Examples

```sh
ezgh kubernetes clusters create prod --subnet sbn_2m9x0a7qpe4k --bot bot_4k2m9x0a7qpe --wait
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--bot` | string |  | the cluster bot (bot\_…), with KubernetesClusterAccess |
| `--control-plane-metrics` | boolean |  | send the control plane's metrics to the cluster's project in Obs, free |
| `--encryption-key` | string |  | a Keys key (kms\_…) to encrypt Kubernetes Secrets with (default an EZGH-managed key) |
| `--logging-project` | string |  | the Obs project the logs go to, by its ID (prj\_…) |
| `--logging-type` | string, repeatable |  | send these control-plane logs to Obs: api, audit, authenticator, controllerManager or scheduler; repeat for more |
| `--maintenance-window` | string |  | when patch updates are made, day:hour UTC (sunday:9) |
| `--no-creator-access` | boolean |  | don't give you cluster admin access |
| `--no-public-access` | boolean |  | close the public endpoint: kubectl reaches it only from inside the VPC |
| `--public-access-cidr` | string, repeatable |  | an IPv4 CIDR that may reach the public endpoint; repeat for more (default 0.0.0.0/0) |
| `--service-ipv4-cidr` | string |  | the IPv4 range Services get addresses from, outside the VPC's (default 10.100.0.0/16) |
| `--subnet` | string |  | the subnet its endpoint's private addresses are in (sbn\_…) |
| `--tag` | string, repeatable |  | a tag, key=value; repeat for more |
| `--version` | string |  | the Kubernetes version, from ezgh kubernetes versions list (default the newest) |
| `--wait` | boolean |  | wait until it's active, and print it then |
| `--wait-timeout` | duration | `45m0s` | how long `--wait` waits |

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

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