Manage Pods
Start a Pod
- Web
- Command line
- Navigate to the Pods page.
- Click the + New Pod button.
- Choose your Pod and click Deploy.
If you're not sure which Pod meets your needs, see Choose a Pod.
- (Optional) Choose a template.
- Click Continue.
- Verify your Pod configuration and click Deploy.
Next, RunPod builds your Pod. You'll start paying for the Pod as soon as it's built.
To start a single Pod, enter the command runpodctl start pod
. You can pass the environment variable RUNPOD_POD_ID
to identify each Pod.
runpodctl start pod $RUNPOD_POD_ID
To start Pods in bulk, enter the command runpodctl create pods
.
For example, to start up to 10 Pods with the name bulk-task
on 3070 and 3080 GPUs and run a bash command, enter the following command.
runpodctl create pods \ --name bulk-task \ --gpuType "NVIDIA GeForce RTX 3070,NVIDIA GeForce RTX 3080" \ --imageName "runpod/your-image-name" \ --containerDiskSize 10 \ --volumeSize 0 \ --mem 1 \ --args "bash -c 'your-bash-command'"
Stop a Pod
- Web
- Command line
- Click the stop icon.
- Confirm by clicking the Stop Pod button.
To stop a Pod, enter the following command.
runpodctl stop pod $RUNPOD_POD_ID
Stop a Pod after a specific time
You can also stop a Pod after a specific amount of time. For example, the following command sleeps for 2 hours, and then stops the Pod.
- SSH
- Web terminal
Use the following command to stop a Pod after 2 hours:
sleep 2h; runpodctl stop pod $RUNPOD_POD_ID &
This command uses sleep to wait for 2 hours before executing the runpodctl stop pod
command to stop the Pod.
The &
at the end runs the command in the background, allowing you to continue using the SSH session.
To stop a Pod after 2 hours using the web terminal, enter:
nohup bash -c "sleep 2h; runpodctl stop pod $RUNPOD_POD_ID" &
nohup
ensures the process continues running if you close the web terminal window.
You are charged for storing idle Pods. If you do not need to store your Pod, be sure to terminate it next.
Terminate a Pod
Terminating a Pod permanently deletes all data outside your network volume. Be sure you've saved any data you want to access again.
- Web
- Command line
- Click the hamburger menu at the bottom of the Pod you want to terminate.
- Click Terminate Pod.
- Confirm by clicking the Yes button.
To remove a single Pod, enter the following command.
runpodctl remove pod $RUNPOD_POD_ID
You can also remove Pods in bulk. For example, the following command terminates up to 40 pods with the name my-bulk-task
.
runpodctl remove pods my-bulk-task --podCount 40
List Pods
If you're using the command line, enter the following command to list your pods.
runpodctl get pod