Skip to main content

Manage Pods with runpodctl

The RunPod CLI makes it easy to manage Pods using your local terminal. Use the commands below to manage your Pods with runpodctl. For a complete list of commands, run runpodctl help.

List all Pods

Run this command to list the details of all Pods associated with your RunPod account:

runpodctl get pod

Example output:

ID            	NAME 	GPU        	IMAGE NAME                                              	STATUS  
wu5ekmn69oh1xr Pod1 1 RTX A5000 runpod/stable-diffusion:web-ui-10.2.1 EXITED
gq9xijdra9hwyd Pod2 1 L4 runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04 RUNNING
kyvwslyyjtf97w Pod3 1 RTX A4500 runpod/stable-diffusion:web-ui-10.2.1 RUNNING

Get details for a Pod

Run this command to get the details of a single Pod:

runpodctl get pod [POD_ID]

Example output:

ID            	NAME 	GPU        	IMAGE NAME                                              	STATUS  
gq9xijdra9hwyd Pod2 1 L4 runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04 RUNNING

Stop a Pod

warning

You will be charged for idle Pods even if they are stopped. If you don't need to retain your Pod environment, you should terminate it completely.

Run this command to stop a Pod:

runpodctl stop pod [POD_ID]

Example output:

pod "gq9xijdra9hwyd" stopped

Resume a Pod

Run this command to resume a Pod that has been stopped:

runpodctl start pod [POD_ID]

Example output:

pod "wu5ekmn69oh1xr" started with $0.290 / hr

Terminate a Pod

danger

Terminating a Pod permanently deletes all data outside your network volume. Be sure you've saved any data you want to access again.

Run this command to terminate a Pod:

runpodctl remove pod [POD_ID]

Example output:

pod "wu5ekmn69oh1xr" removed

You can also terminate a Pod by name:

runpodctl remove pods [POD_NAME]