# `pcluster instances`
<a name="pcluster.instances"></a>

Displays a list of all instances in a cluster.

```
pcluster instances [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Positional arguments
<a name="pcluster.instances.arg"></a>

***cluster\$1name***  
Displays the instances for the cluster with the provided name.

## Named arguments
<a name="pcluster.instances.namedarg"></a>

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

**-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. Defaults to the AWS Region specified by using the [`pcluster configure`](pcluster.configure.md) command.

**Example using AWS ParallelCluster version 2.11.7:**

```
$ pcluster instances -c path/to/config -r us-east-1 mycluster
MasterServer         i-1234567890abcdef0
ComputeFleet         i-abcdef01234567890
```