Reference
Command Line
Home
/
Reference
/
Command Line
/
templates edit

templates edit

Edit the metadata of a template by name.

Usage

coder templates edit [flags] <template>

Options

--name

Typestring

Edit the template name.

--display-name

Typestring

Edit the template display name.

--description

Typestring

Edit the template description.

--deprecated

Typestring

Sets the template as deprecated. Must be a message explaining why the template is deprecated.

--icon

Typestring

Edit the template icon path.

--default-ttl

Typeduration

Edit the template default time before shutdown - workspaces created from this template default to this value. Maps to "Default autostop" in the UI.

--activity-bump

Typeduration

Edit the template activity bump - workspaces created from this template will have their shutdown time bumped by this value when activity is detected. Maps to "Activity bump" in the UI.

--autostart-requirement-weekdays

Type[monday|tuesday|wednesday|thursday|friday|saturday|sunday|all]

Edit the template autostart requirement weekdays - workspaces created from this template can only autostart on the given weekdays. To unset this value for the template (and allow autostart on all days), pass 'all'.

--autostop-requirement-weekdays

Type[monday|tuesday|wednesday|thursday|friday|saturday|sunday|none]

Edit the template autostop requirement weekdays - workspaces created from this template must be restarted on the given weekdays. To unset this value for the template (and disable the autostop requirement for the template), pass 'none'.

--autostop-requirement-weeks

Typeint

Edit the template autostop requirement weeks - workspaces created from this template must be restarted on an n-weekly basis.

--failure-ttl

Typeduration
Default0h

Specify a failure TTL for workspaces created from this template. It is the amount of time after a failed "start" build before coder automatically schedules a "stop" build to cleanup.This licensed feature's default is 0h (off). Maps to "Failure cleanup" in the UI.

--dormancy-threshold

Typeduration
Default0h

Specify a duration workspaces may be inactive prior to being moved to the dormant state. This licensed feature's default is 0h (off). Maps to "Dormancy threshold" in the UI.

--dormancy-auto-deletion

Typeduration
Default0h

Specify a duration workspaces may be in the dormant state prior to being deleted. This licensed feature's default is 0h (off). Maps to "Dormancy Auto-Deletion" in the UI.

--allow-user-cancel-workspace-jobs

Typebool
Defaulttrue

Allow users to cancel in-progress workspace jobs.

--allow-user-autostart

Typebool
Defaulttrue

Allow users to configure autostart for workspaces on this template. This can only be disabled in enterprise.

--allow-user-autostop

Typebool
Defaulttrue

Allow users to customize the autostop TTL for workspaces on this template. This can only be disabled in enterprise.

--require-active-version

Typebool
Defaultfalse

Requires workspace builds to use the active template version. This setting does not apply to template admins. This is an enterprise-only feature. See https://coder.com/docs/admin/templates/managing-templates#require-automatic-updates-enterprise for more details.

--private

Typebool
Defaultfalse

Disable the default behavior of granting template access to the 'everyone' group. The template permissions must be updated to allow non-admin users to use this template.

-y, --yes

Typebool

Bypass prompts.

-O, --org

Typestring
Environment$CODER_ORGANIZATION

Select which organization (uuid or name) to use.

See an opportunity to improve our docs? Make an edit.
On this page