Skip to main content

CoreWeave System Images

Operating System images provided by CoreWeave Cloud include enhancements and features to reduce friction when running Virtual Servers in the Cloud.

Identifying Images

Operating system source images provided by CoreWeave for Virtual Servers live in the vd-images namespace on CoreWeave Cloud. Several metadata properties exist for easy identification.

Using kubectl with the metadata labels listed above, individual images are easily queried.

Metadata labels

LabelDescription
images.coreweave.cloud/familyIdentifies the OS type, usually Windows or Linux
images.coreweave.cloud/featuresIdentifies image specific features, such as Teradici enabled or nVidia drivers
images.coreweave.cloud/idImage ID used during CI/CD
images.coreweave.cloud/latestBoolean tag for the latest image revision
images.coreweave.cloud/nameComplete image name, as displayed in the Web UI
images.coreweave.cloud/os-nameName of the parent OS
images.coreweave.cloud/os-versionSubsection of OS, such as "Standard" or "Professional Edition"
images.coreweave.cloud/privateBoolean tag for testing images, not intended to be used in production environments
images.coreweave.cloud/regionThe datacenter region where the image resides
images.coreweave.cloud/versionDate tag for when the image was built

Example query commands

List all (non-private) latest images available for use

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false

Sort all images by region

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false --sort-by=.spec.storageClassName

Show all Windows images only

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/family=windows

Show all Windows 10 images only

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/os-name=Windows_10

Sort Windows 10 images by region, and extract the image name

Extracting the image name using -o jsonpath='{.items[*].metadata.name}' is useful for things like automation scripts.

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/os-name=Windows_10,images.coreweave.cloud/region=ord1 -o jsonpath='{.items[*].metadata.name}'

Show all Linux images only

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/family=linux

Show all Ubuntu images only

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/os-name=Ubuntu

Show all Ubuntu 20.04 images only

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/name=Ubuntu_20.04

Sort Ubuntu 20.04 images by region, and extract the image name

Extracting the image name using -o jsonpath='{.items[*].metadata.name}' is useful for things like automation scripts.

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/name=Ubuntu_20.04,images.coreweave.cloud/region=ord1 -o jsonpath='{.items[*].metadata.name}'

Show all Linux images and their features, filtered by region

Example
$
kubectl get pvc -n vd-images -l images.coreweave.cloud/latest=true,images.coreweave.cloud/private=false,images.coreweave.cloud/family=linux,images.coreweave.cloud/region=ord1 -o=custom-columns="PVC:metadata.name,NAME:metadata.labels['images\.coreweave\.cloud\/name'],FEATURES:metadata.labels['images\.coreweave\.cloud\/features'],SIZE:status.capacity.storage,STORAGECLASS:.spec.storageClassName" --sort-by='.metadata.name'