Skip to main content
Manage Pods, including creating, listing, starting, stopping, and deleting Pods. 
runpodctl pod <subcommand> [flags]

​
Subcommands

​
List Pods

List all your Pods: 
runpodctl pod list

​
Get Pod details

Get detailed information about a specific Pod, including SSH connection info: 
runpodctl pod get <pod-id>

​
Get flags

​
--include-machine
bool
Include machine information in the output.
​
--include-network-volume
bool
Include network volume information in the output.

​
Create a Pod

Create a new Pod from a template: 
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA RTX 4090"
Create a Pod with a custom Docker image: 
runpodctl pod create --image "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04" --gpu-id "NVIDIA RTX 4090"
Create a CPU-only Pod: 
runpodctl pod create --compute-type cpu --image ubuntu:22.04

​
Create flags

​
--template-id
string
Template ID to use for Pod configuration. Use runpodctl template search to find templates.
​
--image
string
Docker image to use (e.g., runpod/pytorch:latest). Required if no template specified.
​
--name
string
Custom name for the Pod.
​
--gpu-id
string
GPU type (e.g., NVIDIA RTX 4090, NVIDIA A100 80GB PCIe). Use runpodctl gpu list to see available GPUs.
​
--gpu-count
int
default:"1"
Number of GPUs to allocate.
​
--compute-type
string
default:"GPU"
Compute type (GPU or CPU).
​
--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"
Mount path for the persistent volume.
​
--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"}').
​
--cloud-type
string
default:"SECURE"
Cloud tier (SECURE or COMMUNITY).
​
--data-center-ids
string
Comma-separated list of preferred datacenter IDs. Use runpodctl datacenter list to see available datacenters.
​
--global-networking
bool
Enable global networking (Secure Cloud only).
​
--public-ip
bool
Require public IP (Community Cloud only).
​
--ssh
bool
default:"true"
Enable SSH on the Pod.

​
Start a Pod

Start a stopped Pod: 
runpodctl pod start <pod-id>

​
Stop a Pod

Stop a running Pod: 
runpodctl pod stop <pod-id>

​
Restart a Pod

Restart a Pod: 
runpodctl pod restart <pod-id>

​
Reset a Pod

Reset a Pod to its initial state: 
runpodctl pod reset <pod-id>

​
Update a Pod

Update Pod configuration: 
runpodctl pod update <pod-id> --name "new-name"

​
Update flags

​
--name
string
New name for the Pod.
​
--image
string
New Docker image name.
​
--container-disk-in-gb
int
New container disk size in GB.
​
--volume-in-gb
int
New volume size in GB.
​
--volume-mount-path
string
New volume mount path.
​
--ports
string
New comma-separated list of ports.
​
--env
string
New environment variables as a JSON object.

​
Delete a Pod

Delete a Pod: 
runpodctl pod delete <pod-id>

​
Pod URLs

Access exposed ports on your Pod using the following URL pattern: 
https://<pod-id>-<port>.proxy.runpod.net
For example, if your Pod ID is abc123xyz and you exposed port 8888: 
https://abc123xyz-8888.proxy.runpod.net