Skip to main content
Create multiple Pods at once with identical configurations (useful for parallel workloads or distributed training). 
runpodctl create pods [flags]

​
Example

Create 3 identical Pods with the name “training-worker” in the Secure Cloud: 
runpodctl create pods \
  --name "training-worker" \
  --podCount 3 \
  --gpuType "NVIDIA GeForce RTX 3090" \
  --gpuCount 1 \
  --secureCloud \
  --imageName "runpod/pytorch:2.0.1-py3.10-cuda11.8.0-devel"

​
Flags

​
--name
string
A custom name for the Pods. All Pods in the group will share this base name.
​
--podCount
integer
default:1
The number of Pods to create.
​
--gpuType
string
The GPU type to use for the Pods (e.g., NVIDIA GeForce RTX 4090, NVIDIA B200, NVIDIA L40S). Use the GPU ID (long form) from the GPU types reference table to specify the GPU type.
​
--gpuCount
integer
default:1
The number of GPUs to allocate to each Pod.
​
--secureCloud
Create the Pods in the Secure Cloud tier, which offers enterprise-grade infrastructure with enhanced reliability.
​
--communityCloud
Create the Pods in the Community Cloud tier, which typically offers lower pricing with spot instance availability.
​
--imageName
string
The Docker container image to use for the Pods (e.g., runpod/pytorch:latest).
​
--templateId
string
The ID of a template to use for Pod configuration, which pre-defines the image and environment settings.
​
--containerDiskSize
integer
default:20
The size of the container disk in gigabytes for each Pod.
​
--volumeSize
integer
default:1
The size of the persistent volume in gigabytes for each Pod.
​
--volumePath
string
default:"/workspace"
The mount path for the persistent volume inside each container.
​
--networkVolumeId
string
The ID of an existing network volume to attach to all Pods for shared storage.
​
--cost
float
The maximum price ceiling in dollars per hour. If not specified, Pods will be created at the lowest available price.
​
--mem
integer
default:20
The minimum system memory required in gigabytes for each Pod.
​
--vcpu
integer
default:1
The minimum number of vCPUs required for each Pod.
​
--env
string
Environment variables to set in the containers. Specify multiple times for multiple variables.
​
--args
string
Additional arguments to pass to the containers when they start.
​
--ports
string
Ports to expose from the containers. Maximum of 1 HTTP port and 1 TCP port allowed per Pod.