DEMO A showcase of hev ask⌘K agentic search — running on Coder's real docs. Unaffiliated with Coder; not the official documentation. Official Coder docs ↗ Add ask to your docs ↗
Documentation › external-workspaces create

external-workspaces create

Create a new external workspace

Usage

coder external-workspaces 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.

—preset

Typestring
Environment$CODER_PRESET_NAME

Specify the name of a template version preset. Use ‘none’ to explicitly indicate that no preset should be used.

—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.

—no-wait

Typebool
Environment$CODER_CREATE_NO_WAIT

Return immediately after creating the workspace. The build will run in the background.

-y, —yes

Typebool

Bypass confirmation prompts.

—build-option

Typestring-array
Environment$CODER_BUILD_OPTION

Build option value in the format “name=value”.

—build-options

Typebool

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

—ephemeral-parameter

Typestring-array
Environment$CODER_EPHEMERAL_PARAMETER

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

—prompt-ephemeral-parameters

Typebool
Environment$CODER_PROMPT_EPHEMERAL_PARAMETERS

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

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”.

—use-parameter-defaults

Typebool
Environment$CODER_WORKSPACE_USE_PARAMETER_DEFAULTS

Automatically accept parameter defaults when no value is provided.

—always-prompt

Typebool

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

-O, —org

Typestring
Environment$CODER_ORGANIZATION

Select which organization (uuid or name) to use.

esc