# pw environments create

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

## pw environments create

Create a custom environment on a cluster

### Synopsis

The **pw environments create** command creates a custom compute environment on
a cluster, mapping a scheduler partition to an environment that sessions can
be scheduled onto.

The cluster can be given as **pw://user/cluster** for a cluster owned by
another user, or as **cluster** for one of your own.

Wall times are given in the scheduler's own format, for example **24:00:00**.

```
pw environments create [flags]
```

### Examples

```
  # Create a Slurm environment for the gpu partition
  pw environments create --cluster my-hpc --name gpu-large --partition gpu --scheduler slurm
  
  # Create an environment with a display name and wall time limits
  pw environments create --cluster my-hpc --name gpu-large --partition gpu --scheduler slurm \
  --display-name "GPU (large)" --max-time 24:00:00 --default-time 01:00:00
  
  # Create a PBS environment on another user's cluster
  pw environments create --cluster pw://Jake.Thayne/my-hpc --name debug --partition debug --scheduler pbs
```

### Options

```
      --cluster string        Cluster to create the environment on (required)
      --default-time string   Default wall time, for example 01:00:00
      --description string    Description of the environment
      --display-name string   Human-readable name shown in the UI
  -h, --help                  help for create
      --max-time string       Maximum wall time, for example 24:00:00
      --name string           Environment name, unique within the cluster (required)
      --partition string      Scheduler partition to map to (required)
      --scheduler string      Scheduler type: slurm or pbs (required)
```

### 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. Will override any other platform host settings.
  -v, --verbose                Enable verbose logging
```

### SEE ALSO

* [pw environments](/docs/cli/pw/environments)	 - Manage compute environments