template

List, search, and manage templates for Pods and Serverless endpoints.

runpodctl template <subcommand> [flags]

Alias

You can use tpl as a shorthand for template:

runpodctl tpl list

Subcommands

List templates

List available templates:

# List official and community templates (first 10)
runpodctl template list

# List only official templates
runpodctl template list --type official

# List community templates
runpodctl template list --type community

# List your own templates
runpodctl template list --type user

# List all templates including user templates
runpodctl template list --all

# Show more results
runpodctl template list --limit 50

List flags

--type · string

Filter by template type (official, community, user).

--limit · int · default: "10"

Maximum number of results to return.

--offset · int

Number of results to skip for pagination.

--all · bool

Include all templates including user templates.

Search templates

Search for templates by name:

# Search for PyTorch templates
runpodctl template search pytorch

# Search with limit
runpodctl template search comfyui --limit 5

# Search only official templates
runpodctl template search vllm --type official

Search flags

--type · string

Filter by template type (official, community, user).

--limit · int · default: "10"

Maximum number of results to return.

--offset · int

Number of results to skip for pagination.

Get template details

Get detailed information about a specific template, including README, environment variables, and exposed ports:

runpodctl template get <template-id>

Create a template

Create a new template:

# Create a Pod template
runpodctl template create --name "my-template" --image "runpod/pytorch:latest"

# Create a Serverless template
runpodctl template create --name "my-serverless-template" --image "my-image:latest" --serverless

Pod templates vs Serverless templates: Templates are either for Pods or for Serverless endpoints, not both. Pod templates support storage and are used with runpodctl pod create. Serverless templates do not support volume disks and are used with runpodctl serverless create. Use the --serverless flag when creating templates for Serverless endpoints.

Create flags

--name · string · required

Template name.

--image · string · required

Docker image (e.g., runpod/pytorch:latest).

--container-disk-in-gb · int · default: "20"

Container disk size in GB.

--volume-in-gb · int

Persistent volume size in GB.

--volume-mount-path · string · default: "/workspace"

Volume mount path.

--ports · string

Comma-separated list of ports to expose (e.g., 8888/http,22/tcp).

--env · string

Environment variables as a JSON object (e.g., '{"KEY":"value"}').

--docker-start-cmd · string

Comma-separated Docker start commands.

--docker-entrypoint · string

Comma-separated Docker entrypoint commands.

--serverless · bool

Create as a Serverless template. Serverless templates do not support volume disks (--volume-in-gb is not supported). Each Serverless template can only be bound to one endpoint at a time.

--readme · string

Template README content.

Update a template

Update an existing template:

runpodctl template update <template-id> --name "new-name"

Update flags

--name · string

New template name.

--image · string

New Docker image name.

--ports · string

New comma-separated list of ports.

--env · string

New environment variables as a JSON object.

--readme · string

New README content.

--container-disk-in-gb · int

New container disk size in GB.

Delete a template

Delete a template:

runpodctl template delete <template-id>

Related commands

• runpodctl pod create
• runpodctl serverless create