Files
coder/docs/cli/templates_create.md

3.8 KiB
Generated

templates create

Create a template from the current directory or as specified by flag

Usage

coder templates create [flags] [name]

Options

--default-ttl

Type duration
Default 24h

Specify a default TTL for workspaces created from this template. It is the default time before shutdown - workspaces created from this template default to this value. Maps to "Default autostop" in the UI.

-d, --directory

Type string
Default .

Specify the directory to create from, use '-' to read tar from stdin.

--failure-ttl

Type duration
Default 0h

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.

--ignore-lockfile

Type bool
Default false

Ignore warnings about not having a .terraform.lock.hcl file present in the template.

--inactivity-ttl

Type duration
Default 0h

Specify an inactivity TTL for workspaces created from this template. It is the amount of time the workspace is not used before it is be stopped and auto-locked. This includes across multiple builds (e.g. auto-starts and stops). This licensed feature's default is 0h (off). Maps to "Dormancy threshold" in the UI.

--max-ttl

Type duration

Edit the template maximum time before shutdown - workspaces created from this template must shutdown within the given duration after starting. This is an enterprise-only feature.

-m, --message

Type string

Specify a message describing the changes in this version of the template. Messages longer than 72 characters will be displayed as truncated.

--private

Type bool

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.

--provisioner-tag

Type string-array

Specify a set of tags to target provisioner daemons.

--require-active-version

Type bool
Default false

Requires workspace builds to use the active template version. This setting does not apply to template admins. This is an enterprise-only feature.

--var

Type string-array

Alias of --variable.

--variable

Type string-array

Specify a set of values for Terraform-managed variables.

--variables-file

Type string

Specify a file path with values for Terraform-managed variables.

-y, --yes

Type bool

Bypass prompts.