Reference
Command Line

create

Create a workspace

Usage

coder create [flags] [workspace]

Description

  - Create a workspace for another user (if you have permission):

     $ coder create <username>/<workspace_name>

Options

-t, --template

Typestring
Environment$CODER_TEMPLATE_NAME

Specify a template name.

--template-version

Typestring
Environment$CODER_TEMPLATE_VERSION

Specify a template version name.

--start-at

Typestring
Environment$CODER_WORKSPACE_START_AT

Specify the workspace autostart schedule. Check coder schedule start --help for the syntax.

--stop-after

Typeduration
Environment$CODER_WORKSPACE_STOP_AFTER

Specify a duration after which the workspace should shut down (e.g. 8h).

--automatic-updates

Typestring
Environment$CODER_WORKSPACE_AUTOMATIC_UPDATES
Defaultnever

Specify automatic updates setting for the workspace (accepts 'always' or 'never').

--copy-parameters-from

Typestring
Environment$CODER_WORKSPACE_COPY_PARAMETERS_FROM

Specify the source workspace name to copy parameters from.

-y, --yes

Typebool

Bypass prompts.

--parameter

Typestring-array
Environment$CODER_RICH_PARAMETER

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

--rich-parameter-file

Typestring
Environment$CODER_RICH_PARAMETER_FILE

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

Typestring-array
Environment$CODER_RICH_PARAMETER_DEFAULT

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

-O, --org

Typestring
Environment$CODER_ORGANIZATION

Select which organization (uuid or name) to use.

See an opportunity to improve our docs? Make an edit.