Image repository / KubeVirt images / debian-12

Version
202611.15.0
Released
2026-11-15
Architecture
amd64
qcow2 size
431 MB

Run it from the containerdisk

The quickest way to a running VM. The root disk is ephemeral: it is recreated from the image each time the VM starts. Replace the SSH key with your own.

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: debian-12
spec:
  runStrategy: Always
  template:
    spec:
      domain:
        cpu:
          cores: 1
        memory:
          guest: 2Gi
        devices:
          disks:
            - name: rootdisk
              disk:
                bus: virtio
            - name: cloudinit
              disk:
                bus: virtio
          interfaces:
            - name: default
              masquerade: {}
      networks:
        - name: default
          pod: {}
      volumes:
        - name: rootdisk
          containerDisk:
            image: quay.io/cloudsoe/debian-12:202611.15.0
        - name: cloudinit
          cloudInitNoCloud:
            userData: |
              #cloud-config
              ssh_authorized_keys:
                - ssh-ed25519 AAAA... [email protected]
kubectl apply -f debian-12.yaml
kubectl get vmi debian-12 --watch
virtctl ssh debian@vm/debian-12

The image has no password. cloud-init adds your key to the default debian user. On OpenShift, use oc in place of kubectl.

Import it to a persistent disk

With the Containerized Data Importer (CDI, included in OpenShift Virtualization), a DataVolume downloads the qcow2 into a PersistentVolumeClaim of the size you ask for. The root filesystem grows to fill it on first boot.

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: debian-12
spec:
  runStrategy: Always
  dataVolumeTemplates:
    - metadata:
        name: debian-12-root
      spec:
        source:
          http:
            url: https://boxes.cloudsoe.com/kubevirt/debian-12/202611.15.0/debian-12-amd64.qcow2
        storage:
          resources:
            requests:
              storage: 20Gi
  template:
    spec:
      domain:
        cpu:
          cores: 1
        memory:
          guest: 2Gi
        devices:
          disks:
            - name: rootdisk
              disk:
                bus: virtio
            - name: cloudinit
              disk:
                bus: virtio
          interfaces:
            - name: default
              masquerade: {}
      networks:
        - name: default
          pod: {}
      volumes:
        - name: rootdisk
          dataVolume:
            name: debian-12-root
        - name: cloudinit
          cloudInitNoCloud:
            userData: |
              #cloud-config
              ssh_authorized_keys:
                - ssh-ed25519 AAAA... [email protected]

Keep a golden image up to date

A DataImportCron polls the latest tag and imports each new build into a PVC, published as a DataSource that VMs can clone from. On OpenShift, create it in the openshift-virtualization-os-images namespace to keep it with the other boot sources.

apiVersion: cdi.kubevirt.io/v1beta1
kind: DataImportCron
metadata:
  name: cloudsoe-debian-12
spec:
  schedule: "0 3 * * 1"
  managedDataSource: cloudsoe-debian-12
  garbageCollect: Outdated
  importsToKeep: 2
  template:
    spec:
      source:
        registry:
          url: docker://quay.io/cloudsoe/debian-12:latest
      storage:
        resources:
          requests:
            storage: 20Gi

The CDI guide shows how to clone a VM from the resulting DataSource.

Files and verification

FormatLocationChecksum
containerdisk quay.io/cloudsoe/debian-12:202611.15.0 also tagged :latest sha256:c80b1371863b71836de23bef6fad8708f812e3a03ad688ee6d11dc5033b55a80
qcow2 debian-12-amd64.qcow2 431 MB sha256:4427c82a9345c93fbc96b3bffefacc6db5e024fcdeb684e01d65112687245063

For a reproducible deployment, reference the containerdisk by digest instead of by tag:

quay.io/cloudsoe/debian-12@sha256:c80b1371863b71836de23bef6fad8708f812e3a03ad688ee6d11dc5033b55a80

Check a downloaded qcow2 against its published checksum:

curl -LO https://boxes.cloudsoe.com/kubevirt/debian-12/202611.15.0/debian-12-amd64.qcow2
curl -LO https://boxes.cloudsoe.com/kubevirt/debian-12/202611.15.0/debian-12-amd64.qcow2.sha256
sha256sum -c debian-12-amd64.qcow2.sha256

Source image: https://cloud.debian.org/images/cloud/bookworm/latest/debian-12-generic-amd64.qcow2

KubeVirt is a trademark of The Linux Foundation. OpenShift is a trademark of Red Hat. Debian is a trademark of its owner. CloudSOE is not affiliated with or endorsed by them.