# `pcluster create`


Creates a new cluster.

```
pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ]
                [ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ]
                [ -p EXTRA_PARAMETERS ] [ -g TAGS ]
                cluster_name
```

## Positional arguments


***cluster\$1name***  
Defines the name of the cluster. The AWS CloudFormation stack name is `parallelcluster-cluster_name`.

## Named arguments


**-h, --help**  
Shows the help text for `pcluster create`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Specifies the alternative configuration file to use.  
Defaults to `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Specifies the AWS Region to use. The priority order used to select the AWS Region for a new cluster is as follows:  

1. `-r` or `--region` parameter to [`pcluster create`](#pluster.create).

1. `AWS_DEFAULT_REGION` environment variable.

1. `aws_region_name` setting in `[aws]` section of AWS ParallelCluster config file (default location is `~/.parallelcluster/config`.) This is the location updated by the [`pcluster configure`](pcluster.configure.md) command.

1. `region` setting in `[default]` section of AWS CLI config file (`~/.aws/config`.)

**-nw, --nowait**  
Indicates not to wait for stack events after running a stack command.  
Defaults to `False`.

**-nr, --norollback**  
Disables stack rollback on error.  
Defaults to `False`.

**-u *TEMPLATE\$1URL*, --template-url *TEMPLATE\$1URL***  
Specifies a URL for the custom AWS CloudFormation template if it was used when created.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Indicates the cluster template to use.

**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***  
Adds extra parameters to stack create.

**-g *TAGS*, --tags *TAGS***  
Specifies additional tags to add to the stack.

When the command is called and begins polling for the status of that call, it's safe to use "Ctrl-C" to exit. You can return to viewing the current status by calling `pcluster status mycluster`.

**Examples using AWS ParallelCluster version 2.11.7:**

```
$ pcluster create mycluster
    Beginning cluster creation for cluster: mycluster
Info: There is a newer version 3.1.4 of AWS ParallelCluster available.
Creating stack named: parallelcluster-mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
$ pcluster create mycluster --tags '{ "Key1" : "Value1" , "Key2" : "Value2" }'
```