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

# kubox cluster create

Create a cluster from a configuration file

### Synopsis

Submit a configuration file to create a cluster.
The command returns before the cluster is ready.
Run kubox cluster status \<name> to check progress.

Configuration:
Use -f with a Cluster resource or a plain cluster configuration file.
A Cluster resource includes spec.configYAML, the cluster mode, and the cloud account.
For a plain configuration file, use flags to select the cloud account and mode.
Flags override values in either file format, including the cluster name.
Use --plan to review the request without creating a cluster.

To build directly from this machine with your own cloud credentials, use kubox admin create.

```
kubox cluster create [flags]
```

### Options

```
      --cloud-account string      Cloud account to build into, defaulting to the plane's own credentials
  -f, --file string               Cluster resource, or a plain build document
      --gateway-hostname string   Hostname for the cluster's ingress, defaulting to one derived from its name
  -h, --help                      help for create
      --mode string               provisioned (we build it) or adopted (it already exists)
      --name string               Name for the cluster, overriding the document
      --omnigent                  Give the cluster a workload identity, so it can run Omnigent
      --plan                      say what the plane would build and where its state would live, and ask for nothing
```

### Global options

See [global options](/cli-reference/kubox#global-options).

### SEE ALSO

* [kubox cluster](/cli-reference/kubox_cluster)	 - Work with clusters a management plane manages