Add caution/info boxes for VM image virtual size

docs/vm/create-vm.md

@@ -153,6 +153,14 @@ A disk can be made accessible via the following types:
 
 A volume's [StorageClass](../advanced/storageclass.md) can be specified when adding a new empty volume; for other volumes (such as VM images), the `StorageClass` is defined during image creation.
 
+:::info important
+
+When creating volumes from a VM image, ensure that the volume size is greater than or equal to the image size. The volume may become corrupted if the configured volume size is less than the size of the underlying image. This is particularly important for qcow2 images because the virtual size is typically greater than the physical size.
+
+By default, Harvester sets the volume size to either 10 GiB or the virtual size of the VM image, whichever is greater.
+
+:::
+
 ![create-vm](/img/v1.2/vm/create-vm-volumes.png)
 
 ### Adding a container disk

docs/volume/create-volume.md

@@ -83,6 +83,14 @@ resource "harvester_volume" "empty-volume" {
 1. Select an existing `Image`.
 1. Configure the `Size` of the volume.
 
+:::info important
+
+When creating volumes from a VM image, ensure that the volume size is greater than or equal to the image size. The volume may become corrupted if the configured volume size is less than the size of the underlying image. This is particularly important for qcow2 images because the virtual size is typically greater than the physical size.
+
+By default, Harvester will set the volume size to the virtual size of the image.
+
+:::
+
 ![create-image-volume](/img/v1.2/volume/create-image-volume.png)
 
 </TabItem>

versioned_docs/version-v1.2/vm/create-vm.md

@@ -57,6 +57,14 @@ A disk can be made accessible via the following types:
 
 A volume's [StorageClass](../advanced/storageclass.md) can be specified when adding a new empty volume; for other volumes (such as VM images), the `StorageClass` is defined during image creation.
 
+:::caution
+
+When creating volumes from a VM image, ensure that the volume size is greater than or equal to the image size. The volume may become corrupted if the configured volume size is less than the size of the underlying image. This is particularly important for qcow2 images because the virtual size is typically greater than the physical size. 
+
+Harvester sets the volume size to 10 GiB by default. You must verify if this value is sufficient and then modify it if necessary. To determine the virtual size of a qcow2 image, you can run the command `qemu-img info YOUR_IMAGE_FILE.qcow2`.
+
+:::
+
 ![create-vm](/img/v1.2/vm/create-vm-volumes.png)
 
 ### Adding a container disk

versioned_docs/version-v1.2/volume/create-volume.md

@@ -38,4 +38,12 @@ description: Create a volume from the Volume page.
 1. Select an existing `Image`.
 1. Configure the `Size` of the volume.
 
-![create-image-volume](/img/v1.2/volume/create-image-volume.png)
+:::caution
+
+When creating volumes from a VM image, ensure that the volume size is greater than or equal to the image size. The volume may become corrupted if the configured volume size is less than the size of the underlying image. This is particularly important for qcow2 images because the virtual size is typically greater than the physical size.
+
+To determine the virtual size of a qcow2 image, you can run the command `qemu-img info YOUR_IMAGE_FILE.qcow2`.
+
+:::
+
+![create-image-volume](/img/v1.2/volume/create-image-volume.png)

versioned_docs/version-v1.3/vm/create-vm.md

@@ -57,6 +57,14 @@ A disk can be made accessible via the following types:
 
 A volume's [StorageClass](../advanced/storageclass.md) can be specified when adding a new empty volume; for other volumes (such as VM images), the `StorageClass` is defined during image creation.
 
+:::caution
+
+When creating volumes from a VM image, ensure that the volume size is greater than or equal to the image size. The volume may become corrupted if the configured volume size is less than the size of the underlying image. This is particularly important for qcow2 images because the virtual size is typically greater than the physical size. 
+
+Harvester sets the volume size to 10 GiB by default. You must verify if this value is sufficient and then modify it if necessary. To determine the virtual size of a qcow2 image, you can run the command `qemu-img info YOUR_IMAGE_FILE.qcow2`.
+
+:::
+
 ![create-vm](/img/v1.2/vm/create-vm-volumes.png)
 
 ### Adding a container disk

versioned_docs/version-v1.3/volume/create-volume.md

@@ -38,4 +38,12 @@ description: Create a volume from the Volume page.
 1. Select an existing `Image`.
 1. Configure the `Size` of the volume.
 
+:::caution
+
+When creating volumes from a VM image, ensure that the volume size is greater than or equal to the image size. The volume may become corrupted if the configured volume size is less than the size of the underlying image. This is particularly important for qcow2 images because the virtual size is typically greater than the physical size.
+
+To determine the virtual size of a qcow2 image, you can run the command `qemu-img info YOUR_IMAGE_FILE.qcow2`.
+
+:::
+
 ![create-image-volume](/img/v1.2/volume/create-image-volume.png)