Coder powers secure, scalable development across key industries — automotive, finance, government, and technology — enabling faster builds, tighter compliance, and seamless AI adoption in enterprise-grade cloud environments.
Will update and start a given workspace if it is out of date. If the workspace is already running, it will be stopped first.
Usage
coder update [flags] <workspace>
Description
Use --always-prompt to change the parameter values of the workspace.
Options
-y, --yes
Type
bool
Bypass confirmation prompts.
--build-option
Type
string-array
Environment
$CODER_BUILD_OPTION
Build option value in the format "name=value".
--build-options
Type
bool
Prompt for one-time build options defined with ephemeral parameters.
--ephemeral-parameter
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
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
Type
string-array
Environment
$CODER_RICH_PARAMETER
Rich parameter value in the format "name=value".
--rich-parameter-file
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
Type
string-array
Environment
$CODER_RICH_PARAMETER_DEFAULT
Rich parameter default values in the format "name=value".
--use-parameter-defaults
Type
bool
Environment
$CODER_WORKSPACE_USE_PARAMETER_DEFAULTS
Automatically accept parameter defaults when no value is provided.
--always-prompt
Type
bool
Always prompt all parameters. Does not pull parameter values from existing workspace.
