2023-03-23 22:42:20 +00:00
|
|
|
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
|
|
|
|
|
|
|
# create
|
|
|
|
|
|
|
|
Create a workspace
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
```console
|
|
|
|
coder create [flags] [name]
|
|
|
|
```
|
|
|
|
|
2023-07-14 13:48:02 +00:00
|
|
|
## Description
|
|
|
|
|
|
|
|
```console
|
|
|
|
- Create a workspace for another user (if you have permission):
|
|
|
|
|
2023-09-07 21:28:22 +00:00
|
|
|
$ coder create <username>/<workspace_name>
|
2023-07-14 13:48:02 +00:00
|
|
|
```
|
|
|
|
|
2023-03-23 22:42:20 +00:00
|
|
|
## Options
|
|
|
|
|
2024-03-15 16:24:38 +00:00
|
|
|
### -t, --template
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | --------------------------------- |
|
|
|
|
| Type | <code>string</code> |
|
|
|
|
| Environment | <code>$CODER_TEMPLATE_NAME</code> |
|
|
|
|
|
|
|
|
Specify a template name.
|
|
|
|
|
|
|
|
### --start-at
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | -------------------------------------- |
|
|
|
|
| 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
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | ---------------------------------------- |
|
|
|
|
| Type | <code>duration</code> |
|
|
|
|
| Environment | <code>$CODER_WORKSPACE_STOP_AFTER</code> |
|
|
|
|
|
|
|
|
Specify a duration after which the workspace should shut down (e.g. 8h).
|
|
|
|
|
2023-10-06 09:27:12 +00:00
|
|
|
### --automatic-updates
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | ----------------------------------------------- |
|
|
|
|
| Type | <code>string</code> |
|
|
|
|
| Environment | <code>$CODER_WORKSPACE_AUTOMATIC_UPDATES</code> |
|
|
|
|
| Default | <code>never</code> |
|
|
|
|
|
|
|
|
Specify automatic updates setting for the workspace (accepts 'always' or 'never').
|
|
|
|
|
2023-11-09 18:22:47 +00:00
|
|
|
### --copy-parameters-from
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | -------------------------------------------------- |
|
|
|
|
| Type | <code>string</code> |
|
|
|
|
| Environment | <code>$CODER_WORKSPACE_COPY_PARAMETERS_FROM</code> |
|
|
|
|
|
|
|
|
Specify the source workspace name to copy parameters from.
|
|
|
|
|
2024-03-15 16:24:38 +00:00
|
|
|
### -y, --yes
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ---- | ----------------- |
|
|
|
|
| Type | <code>bool</code> |
|
|
|
|
|
|
|
|
Bypass prompts.
|
|
|
|
|
2023-08-09 11:00:25 +00:00
|
|
|
### --parameter
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | ---------------------------------- |
|
|
|
|
| Type | <code>string-array</code> |
|
|
|
|
| Environment | <code>$CODER_RICH_PARAMETER</code> |
|
|
|
|
|
|
|
|
Rich parameter value in the format "name=value".
|
|
|
|
|
2023-03-23 22:42:20 +00:00
|
|
|
### --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.
|
2024-04-29 18:23:54 +00:00
|
|
|
|
|
|
|
### --parameter-default
|
|
|
|
|
|
|
|
| | |
|
|
|
|
| ----------- | ------------------------------------------ |
|
|
|
|
| Type | <code>string-array</code> |
|
|
|
|
| Environment | <code>$CODER_RICH_PARAMETER_DEFAULT</code> |
|
|
|
|
|
|
|
|
Rich parameter default values in the format "name=value".
|