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

​
Delete a template

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