Files
coder/docs/reference/cli/external-workspaces/create.md
T
Nick Vigilante 2ee96f82f9 docs: give every table header cell text and fail lint on empty ones
Screen readers announce a table header cell with no text as an unnamed
column, and axe reports it as empty-table-header.

- clidocgen writes "Property | Value" over each option's metadata table
  instead of an empty header row; the CLI reference is regenerated.
- The port-forwarding CORS matrix labels its corner cells (From user,
  From workspace, To user, To workspace, To app).
- Four Markdown matrices get a corner label, byte-identical to #30873.
- docshtmlcheck (make lint/docs-html) now fails on empty header cells in
  Markdown pipe tables and raw HTML tables, naming the file, line, and
  the table's first header.

Assisted-by: AI
2026-10-15 16:48:16 -04:00

6.3 KiB
Generated

title, description
title description
`coder external-workspaces create` Create a new external workspace

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

Property Value
Type string
Environment $CODER_TEMPLATE_NAME

Specify a template name.

--template-version

Property Value
Type string
Environment $CODER_TEMPLATE_VERSION

Specify a template version name or ID.

--preset

Property Value
Type string
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

Property Value
Type string
Environment $CODER_WORKSPACE_START_AT

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

--stop-after

Property Value
Type duration
Environment $CODER_WORKSPACE_STOP_AFTER

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

--automatic-updates

Property Value
Type string
Environment $CODER_WORKSPACE_AUTOMATIC_UPDATES
Default never

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

--copy-parameters-from

Property Value
Type string
Environment $CODER_WORKSPACE_COPY_PARAMETERS_FROM

Specify the source workspace name to copy parameters from.

--no-wait

Property Value
Type bool
Environment $CODER_CREATE_NO_WAIT

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

-y, --yes

Property Value
Type bool

Bypass confirmation prompts.

--build-option

Property Value
Type string-array
Environment $CODER_BUILD_OPTION

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

--build-options

Property Value
Type bool

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

--ephemeral-parameter

Property Value
Type string-array
Environment $CODER_EPHEMERAL_PARAMETER

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

--prompt-ephemeral-parameters

Property Value
Type bool
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

Property Value
Type string-array
Environment $CODER_RICH_PARAMETER

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

--rich-parameter-file

Property Value
Type string
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

Property Value
Type string-array
Environment $CODER_RICH_PARAMETER_DEFAULT

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

--use-parameter-defaults

Property Value
Type bool
Environment $CODER_WORKSPACE_USE_PARAMETER_DEFAULTS

Automatically accept parameter defaults when no value is provided.

--always-prompt

Property Value
Type bool

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

-O, --org

Property Value
Type string
Environment $CODER_ORGANIZATION

Select which organization (uuid or name) to use.