# pw cluster create

> Source: https://parallelworks.com/docs/cli/pw/cluster/create

## pw cluster create

Create a cluster

### Synopsis

The **pw cluster create** command creates a cluster record. Pass the full
definition with **--definition** (a JSON or YAML file, or **-** for stdin) to
create a ready-to-start cluster in one step, or **--from** to copy another
cluster's definition and alerts, the way the web's Duplicate action does.
Without either, the cluster is created empty and configured later with
**pw cluster definition set**.

Names may only contain lowercase letters and digits; the name becomes the
display name unless **--display-name** is given.

Pass **--start** to provision the cluster as soon as it is created; the
**-o** and **--wait** flags then behave as in **pw cluster start**.

```
pw cluster create <name> [flags]
```

### Examples

```
  # Create an AWS cluster from a definition file and start it
  pw cluster create --type aws-slurm --definition cluster.yaml --start myhpc
  
  # Copy an existing cluster's definition under a new name
  pw cluster create --from pw://Jake.Thayne/prodhpc myhpc
  
  # Create an empty Google cluster to configure later
  pw cluster create --type google-slurm --description "scratch" myhpc
  pw cluster definition get myhpc > def.json
  pw cluster definition set -f def.json myhpc
  
  # Register an existing (on-prem) cluster
  pw cluster create --type existing onprem
```

### Options

```
      --definition string     JSON or YAML file with the cluster definition (- for stdin)
      --description string    Description
      --display-name string   Display name (defaults to the name)
      --from string           Cluster whose definition and alerts to copy
  -h, --help                  help for create
  -o, --output string         Output format (interactive, text, json); interactive opens the live view when --start is given (default "interactive")
      --start                 Provision the cluster once it is created
      --type string           Cluster type: aws-slurm, google-slurm, azure-slurm, oracle-slurm, openstack-slurm, existing (required unless --from is given)
      --wait                  With --start, wait for the cluster to be active before exiting
```

### Options inherited from parent commands

```
      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Overrides PW_PLATFORM_HOST environment variable and the current context's server.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw cluster](/docs/cli/pw/cluster)	 - Manage clusters