# restart

Restart a workspace

## Usage [#usage]

```console
coder restart [flags] <workspace>
```

## Options [#options]

### -y, --yes [#-y---yes]

|      |                   |
| ---- | ----------------- |
| Type | <code>bool</code> |

Bypass confirmation prompts.

### --build-option [#--build-option]

|             |                                    |
| ----------- | ---------------------------------- |
| Type        | <code>string-array</code>          |
| Environment | <code>$CODER\_BUILD\_OPTION</code> |

Build option value in the format "name=value".

### --build-options [#--build-options]

|      |                   |
| ---- | ----------------- |
| Type | <code>bool</code> |

Prompt for one-time build options defined with ephemeral parameters.

### --ephemeral-parameter [#--ephemeral-parameter]

|             |                                           |
| ----------- | ----------------------------------------- |
| Type        | <code>string-array</code>                 |
| Environment | <code>$CODER\_EPHEMERAL\_PARAMETER</code> |

Set the value of ephemeral parameters defined in the template. The format is "name=value".

### --prompt-ephemeral-parameters [#--prompt-ephemeral-parameters]

|             |                                                    |
| ----------- | -------------------------------------------------- |
| Type        | <code>bool</code>                                  |
| Environment | <code>$CODER\_PROMPT\_EPHEMERAL\_PARAMETERS</code> |

Prompt to set values of ephemeral parameters defined in the template. If a value has been set via --ephemeral-parameter, it will not be prompted for.

### --parameter [#--parameter]

|             |                                      |
| ----------- | ------------------------------------ |
| Type        | <code>string-array</code>            |
| Environment | <code>$CODER\_RICH\_PARAMETER</code> |

Rich parameter value in the format "name=value".

### --rich-parameter-file [#--rich-parameter-file]

|             |                                            |
| ----------- | ------------------------------------------ |
| Type        | <code>string</code>                        |
| Environment | <code>$CODER\_RICH\_PARAMETER\_FILE</code> |

Specify a file path with values for rich parameters defined in the template. The file should be in YAML format, containing key-value pairs for the parameters.

### --parameter-default [#--parameter-default]

|             |                                               |
| ----------- | --------------------------------------------- |
| Type        | <code>string-array</code>                     |
| Environment | <code>$CODER\_RICH\_PARAMETER\_DEFAULT</code> |

Rich parameter default values in the format "name=value".

### --use-parameter-defaults [#--use-parameter-defaults]

|             |                                                          |
| ----------- | -------------------------------------------------------- |
| Type        | <code>bool</code>                                        |
| Environment | <code>$CODER\_WORKSPACE\_USE\_PARAMETER\_DEFAULTS</code> |

Automatically accept parameter defaults when no value is provided.

### --always-prompt [#--always-prompt]

|      |                   |
| ---- | ----------------- |
| Type | <code>bool</code> |

Always prompt all parameters. Does not pull parameter values from existing workspace.