pod

Manage Pods, including creating, listing, starting, stopping, and deleting Pods.

runpodctl <subcommand> pod [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:2.8.0-py3.11-cuda12.8.1-cudnn-devel-ubuntu22.04). 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.

--min-cuda-version · 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.

--docker-args · string

Docker arguments passed to the container at runtime (e.g., "sleep infinity").

--registry-auth-id · string

Container registry authentication ID for pulling private images. Use runpodctl registry list to see available registry credentials.

--country-code · string

Country code for regional deployment (e.g., US, CA, EU). Restricts Pod placement to machines in the specified region.

--stop-after · string

Automatically stop the Pod after the specified duration (e.g., 1h, 24h, 7d).

--terminate-after · string

Automatically terminate the Pod after the specified duration (e.g., 1h, 24h, 7d). Unlike --stop-after, this permanently deletes the Pod.

--compliance · string

Compliance settings for the Pod (e.g., regulatory requirements for data handling).

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

Related commands

• runpodctl gpu list
• runpodctl template
• runpodctl ssh