Skip to main content
Manage Pods, including creating, listing, starting, stopping, and deleting Pods.

Subcommands

List Pods

List your Pods. By default, this command shows only running Pods (similar to docker ps):
List all Pods including exited ones:
Filter by status:
Filter by creation time:

List flags

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

Get Pod details

Get detailed information about a specific Pod, including SSH connection info:

Create a Pod

Create a new Pod from a template:
Create a Pod with a custom Docker image:
Create a CPU-only Pod:

Create flags

string
Template ID to use for Pod configuration. Use runpodctl template search to find templates.
string
Docker image to use (e.g., runpod/pytorch:2.8.0-py3.11-cuda12.8.1-cudnn-devel-ubuntu22.04). Required if no template specified.
string
Custom name for the Pod.
string
GPU type (e.g., NVIDIA GeForce RTX 4090, NVIDIA A100 80GB PCIe). Use runpodctl gpu list to see available GPUs.
int
default:"1"
Number of GPUs to allocate.
string
default:"GPU"
Compute type (GPU or CPU).
int
default:"20"
Container disk size in GB.
int
Persistent volume size in GB.
string
default:"/workspace"
Mount path for the persistent volume.
string
Comma-separated list of ports to expose (e.g., 8888/http,22/tcp).
string
Environment variables as a JSON object (e.g., '{"KEY":"value"}').
string
default:"SECURE"
Cloud tier (SECURE or COMMUNITY).
string
Comma-separated list of preferred datacenter IDs. Use runpodctl datacenter list to see available datacenters.
bool
Enable global networking (Secure Cloud only).
bool
Require public IP (Community Cloud only).
bool
default:"true"
Enable SSH on the Pod.
string
Network volume ID to attach. Use runpodctl network-volume list to see available network volumes.
string
Minimum CUDA version required (e.g., 11.8, 12.4). The Pod will only be scheduled on machines that meet this CUDA version requirement.
string
Docker arguments passed to the container at runtime (e.g., "sleep infinity").
string
Container registry authentication ID for pulling private images. Use runpodctl registry list to see available registry credentials.
string
Country code for regional deployment (e.g., US, CA, EU). Restricts Pod placement to machines in the specified region.
string
Compliance settings for the Pod (e.g., regulatory requirements for data handling).

Start a Pod

Start a stopped Pod:

Stop a Pod

Stop a running Pod:

Restart a Pod

Restart a Pod:

Reset a Pod

Reset a Pod to its initial state:

Update a Pod

Update Pod configuration:

Update flags

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

Delete a Pod

Delete a Pod:

Pod URLs

Access exposed ports on your Pod using the following URL pattern:
For example, if your Pod ID is abc123xyz and you exposed port 8888:
Last modified on October 5, 2026