# pw workers create

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

## pw workers create

Pre-provision a compute worker

### Synopsis

The **pw workers create** command submits a scheduler job that pre-provisions a
compute worker, so sessions can start on it without waiting in the queue. Start
a session on it with **pw session create --worker**.

The cluster can be given as **pw://user/cluster**, **pw://cluster** or
**cluster**, where an omitted user defaults to your username.

Pass **--environment** to schedule the worker onto an environment, which
determines the partition and validates **--param** values against the
environment's schema. Run **pw environments get** to see which parameters an
environment accepts.

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

### Examples

```
  # Pre-provision a worker on an environment
  pw workers create --environment gpu-large my-hpc
  
  # Request two nodes for a longer wall time
  pw workers create --environment gpu-large --param numNodes=2 --param walltime=04:00:00 my-hpc
  
  # Pre-provision on a partition directly, without an environment
  pw workers create --partition gpu my-hpc
```

### Options

```
      --environment string   Environment to schedule the worker onto, by name or ID
  -h, --help                 help for create
      --param stringArray    Scheduling parameter as key=value (repeatable)
      --partition string     Scheduler partition to use when no environment is given
```

### 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 workers](/docs/cli/pw/workers)	 - Manage compute workers