Skip to main content
List, search, and manage templates for Pods and Serverless endpoints.

​
Alias

You can use tpl as a shorthand for template:

​
Subcommands

​
List templates

List available templates:

​
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 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:

​
Create a template

Create a new template:
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:2.8.0-py3.11-cuda12.8.1-cudnn-devel-ubuntu22.04).
​
--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:

​
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: