Image repository / KubeVirt images / debian-13

Version
202611.15.0
Released
2026-11-15
Architecture
amd64
qcow2 size
417 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-13
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-13:202611.15.0
        - name: cloudinit
          cloudInitNoCloud:
            userData: |
              #cloud-config
              ssh_authorized_keys:
                - ssh-ed25519 AAAA... [email protected]
kubectl apply -f debian-13.yaml
kubectl get vmi debian-13 --watch
virtctl ssh debian@vm/debian-13

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-13
spec:
  runStrategy: Always
  dataVolumeTemplates:
    - metadata:
        name: debian-13-root
      spec:
        source:
          http:
            url: https://boxes.cloudsoe.com/kubevirt/debian-13/202611.15.0/debian-13-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-13-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-13
spec:
  schedule: "0 3 * * 1"
  managedDataSource: cloudsoe-debian-13
  garbageCollect: Outdated
  importsToKeep: 2
  template:
    spec:
      source:
        registry:
          url: docker://quay.io/cloudsoe/debian-13: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-13:202611.15.0 also tagged :latest sha256:e214ca04fda22579728b0633fff7d7bf19fd2a1da055808e85e6ce8729d235ae
qcow2 debian-13-amd64.qcow2 417 MB sha256:2f07a725b9370b94a9d7d7e8d68e7d424bc6096f7ccb2dbdaad5f203e6244d9b

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

quay.io/cloudsoe/debian-13@sha256:e214ca04fda22579728b0633fff7d7bf19fd2a1da055808e85e6ce8729d235ae

Check a downloaded qcow2 against its published checksum:

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

Source image: https://cloud.debian.org/images/cloud/trixie/latest/debian-13-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.