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

​
Subcommands

​
List Pods

List your Pods. By default, this command shows only running Pods (similar to docker ps): 
runpodctl pod list
List all Pods including exited ones: 
runpodctl pod list --all
Filter by status: 
runpodctl pod list --status exited
Filter by creation time: 
# Pods created in the last 24 hours
runpodctl pod list --since 24h

# Pods created in the last 7 days
runpodctl pod list --since 7d

# Pods created after a specific date
runpodctl pod list --created-after 2025-01-15

​
List flags

​
--all, -a
bool
Show all Pods including exited ones. By default, only running Pods are shown.
​
--status
string
Filter by Pod status (e.g., RUNNING, EXITED). Cannot be used with --all.
​
--since
string
Filter Pods created within the specified duration (e.g., 1h, 24h, 7d). Cannot be used with --created-after.
​
--created-after
string
Filter Pods created after the specified date in YYYY-MM-DD format. Cannot be used with --since.
​
--compute-type
string
Filter by compute type (GPU or CPU).
​
--name
string
Filter by Pod name.

​
Get Pod details

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

​
Create a Pod

Create a new Pod from a template: 
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA GeForce RTX 4090"
Create a Pod with a custom Docker image: 
runpodctl pod create --image "runpod/pytorch:1.0.3-cu1281-torch291-ubuntu2404" --gpu-id "NVIDIA GeForce 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 GeForce 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.
​
--network-volume-id
string
Network volume ID to attach. Use runpodctl network-volume list to see available network volumes.

​
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