---
title: "ezgh kubernetes node-groups create"
description: "Add a node group to 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 node-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 kubernetes node-groups create <name> --cluster c --instance-type t --subnet s --bot b --min n --max n [flags] [--wait]
```

Add a node group to a cluster: instances of one type in a private subnet of the cluster's VPC. `--bot` is the node bot, which needs KubernetesNodeAccess; the cluster's bot needs bots.pass on it. Its version defaults to the cluster's. A node group has at most 100 nodes, a cluster 300, and each node runs at most 110 pods. `--wait` waits until its nodes have joined and prints it.

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

## Examples

```sh
ezgh kubernetes node-groups create web --cluster prod --instance-type gp-1.large --subnet sbn_2m9x0a7qpe4k \
  --bot bot_7qpe4k2m9x0a --min 1 --max 5 --wait
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--bot` | string |  | the node bot (bot\_…), with KubernetesNodeAccess |
| `--cluster` | string |  | the cluster |
| `--desired` | int |  | how many nodes to start with (default `--min`) |
| `--instance-type` | string |  | the nodes' instance type, from ezgh compute instance-types list |
| `--label` | string, repeatable |  | a Kubernetes label on each node, key=value; repeat for more |
| `--max` | int |  | the most nodes, at most 100 |
| `--max-unavailable-percent` | int |  | the share of nodes replaced at once in an upgrade (default 25) |
| `--min` | int |  | the fewest nodes, 0 or more |
| `--root-volume-size-gib` | int |  | each node's root volume, in GiB |
| `--ssh-key` | string, repeatable |  | an SSH key (ssh\_…) on each node; repeat for more |
| `--subnet` | string |  | a private subnet of the cluster's VPC (sbn\_…) |
| `--tag` | string, repeatable |  | a tag, key=value; repeat for more |
| `--taint` | string, repeatable |  | a taint on each node, key=value:Effect or key:Effect; repeat for more |
| `--version` | string |  | the nodes' Kubernetes version (default the cluster's) |
| `--wait` | boolean |  | wait until it's active, and print it then |
| `--wait-timeout` | duration | `30m0s` | how long `--wait` waits |

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

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