2023-03-23 17:42:20 -05:00
<!-- DO NOT EDIT | GENERATED CONTENT -->
# create
Create a workspace
## Usage
```console
2024-12-05 02:32:52 +01:00
coder create [flags] [workspace]
2023-03-23 17:42:20 -05:00
```
2023-07-14 09:48:02 -04:00
## Description
```console
- Create a workspace for another user (if you have permission):
2023-09-07 17:28:22 -04:00
$ coder create <username>/<workspace_name>
2023-07-14 09:48:02 -04:00
```
2023-03-23 17:42:20 -05:00
## Options
2024-03-15 11:24:38 -05:00
### -t, --template
2023-10-06 13:27:12 +04:00
2024-03-15 11:24:38 -05:00
| | |
2025-01-03 18:12:59 +05:00
|-------------|-----------------------------------|
2024-03-15 11:24:38 -05:00
| Type | <code>string</code> |
| Environment | <code>$CODER_TEMPLATE_NAME</code> |
2023-10-06 13:27:12 +04:00
2024-03-15 11:24:38 -05:00
Specify a template name.
2023-03-23 17:42:20 -05:00
2024-10-11 18:30:11 +05:30
### --template-version
| | |
2025-01-03 18:12:59 +05:00
|-------------|--------------------------------------|
2024-10-11 18:30:11 +05:30
| Type | <code>string</code> |
| Environment | <code>$CODER_TEMPLATE_VERSION</code> |
Specify a template version name.
2025-07-28 14:46:04 +01:00
### --preset
| | |
|-------------|---------------------------------|
| Type | <code>string</code> |
| Environment | <code>$CODER_PRESET_NAME</code> |
Specify the name of a template version preset. Use 'none' to explicitly indicate that no preset should be used.
2023-03-23 17:42:20 -05:00
### --start-at
| | |
2025-01-03 18:12:59 +05:00
|-------------|----------------------------------------|
2023-03-23 17:42:20 -05:00
| Type | <code>string</code> |
| Environment | <code>$CODER_WORKSPACE_START_AT</code> |
Specify the workspace autostart schedule. Check coder schedule start --help for the syntax.
### --stop-after
| | |
2025-01-03 18:12:59 +05:00
|-------------|------------------------------------------|
2023-03-23 17:42:20 -05:00
| Type | <code>duration</code> |
| Environment | <code>$CODER_WORKSPACE_STOP_AFTER</code> |
Specify a duration after which the workspace should shut down (e.g. 8h).
2024-03-15 11:24:38 -05:00
### --automatic-updates
2023-03-23 17:42:20 -05:00
2024-03-15 11:24:38 -05:00
| | |
2025-01-03 18:12:59 +05:00
|-------------|-------------------------------------------------|
2024-03-15 11:24:38 -05:00
| Type | <code>string</code> |
| Environment | <code>$CODER_WORKSPACE_AUTOMATIC_UPDATES</code> |
| Default | <code>never</code> |
2023-03-23 17:42:20 -05:00
2024-03-15 11:24:38 -05:00
Specify automatic updates setting for the workspace (accepts 'always' or 'never').
### --copy-parameters-from
| | |
2025-01-03 18:12:59 +05:00
|-------------|----------------------------------------------------|
2024-03-15 11:24:38 -05:00
| Type | <code>string</code> |
| Environment | <code>$CODER_WORKSPACE_COPY_PARAMETERS_FROM</code> |
Specify the source workspace name to copy parameters from.
2023-03-23 17:42:20 -05:00
### -y, --yes
| | |
2025-01-03 18:12:59 +05:00
|------|-------------------|
2023-03-23 17:42:20 -05:00
| Type | <code>bool</code> |
Bypass prompts.
2024-03-15 11:24:38 -05:00
### --parameter
| | |
2025-01-03 18:12:59 +05:00
|-------------|------------------------------------|
2024-03-15 11:24:38 -05:00
| Type | <code>string-array</code> |
| Environment | <code>$CODER_RICH_PARAMETER</code> |
Rich parameter value in the format "name=value".
### --rich-parameter-file
| | |
2025-01-03 18:12:59 +05:00
|-------------|-----------------------------------------|
2024-03-15 11:24:38 -05:00
| Type | <code>string</code> |
| Environment | <code>$CODER_RICH_PARAMETER_FILE</code> |
2024-10-09 10:04:24 +05:30
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.
2024-04-29 11:23:54 -07:00
### --parameter-default
| | |
2025-01-03 18:12:59 +05:00
|-------------|--------------------------------------------|
2024-04-29 11:23:54 -07:00
| Type | <code>string-array</code> |
| Environment | <code>$CODER_RICH_PARAMETER_DEFAULT</code> |
Rich parameter default values in the format "name=value".
2024-07-01 11:04:45 -10:00
### -O, --org
| | |
2025-01-03 18:12:59 +05:00
|-------------|----------------------------------|
2024-07-01 11:04:45 -10:00
| Type | <code>string</code> |
| Environment | <code>$CODER_ORGANIZATION</code> |
Select which organization (uuid or name) to use.