Skip to main content
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

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.
--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.

Delete a template

Delete a template:
runpodctl template delete <template-id>