diff --git a/docs/guides/cloud-image.md b/docs/guides/cloud-image.md
index 2ba46c06..ce593f1a 100644
--- a/docs/guides/cloud-image.md
+++ b/docs/guides/cloud-image.md
@@ -109,11 +109,12 @@ resource "proxmox_virtual_environment_vm" "debian_vm" {
 
   disk {
     datastore_id = "local-lvm"
-    file_id      = "local:iso/debian-12-genericcloud-amd64.img"
-    interface    = "virtio0"
-    iothread     = true
-    discard      = "on"
-    size         = 20
+    # qcow2 image downloaded from https://cloud.debian.org/images/cloud/bookworm/latest/ and renamed to *.img
+    file_id   = "local:iso/debian-12-genericcloud-amd64.img"
+    interface = "virtio0"
+    iothread  = true
+    discard   = "on"
+    size      = 20
   }
 }
 ```
diff --git a/docs/guides/cloud-init.md b/docs/guides/cloud-init.md
index e44220fc..4c922a41 100644
--- a/docs/guides/cloud-init.md
+++ b/docs/guides/cloud-init.md
@@ -21,6 +21,9 @@ resource "proxmox_virtual_environment_vm" "ubuntu_vm" {
   name      = "test-ubuntu"
   node_name = "pve"
 
+  # should be true if qemu agent is not installed / enabled on the VM
+  stop_on_destroy = true
+
   initialization {
     ip_config {
       ipv4 {
diff --git a/examples/guides/cloud-image/debian-from-storage/main.tf b/examples/guides/cloud-image/debian-from-storage/main.tf
index 10ef21ed..e0767b37 100644
--- a/examples/guides/cloud-image/debian-from-storage/main.tf
+++ b/examples/guides/cloud-image/debian-from-storage/main.tf
@@ -15,11 +15,11 @@ resource "proxmox_virtual_environment_vm" "debian_vm" {
 
   disk {
     datastore_id = "local-lvm"
-    file_id      = "local:iso/debian-12-genericcloud-amd64.img"
-    interface    = "virtio0"
-    iothread     = true
-    discard      = "on"
-    size         = 20
+    # qcow2 image downloaded from https://cloud.debian.org/images/cloud/bookworm/latest/ and renamed to *.img
+    file_id   = "local:iso/debian-12-genericcloud-amd64.img"
+    interface = "virtio0"
+    iothread  = true
+    discard   = "on"
+    size      = 20
   }
 }
-
diff --git a/examples/guides/cloud-init/native/main.tf b/examples/guides/cloud-init/native/main.tf
index 2e3a13b9..674c7a83 100644
--- a/examples/guides/cloud-init/native/main.tf
+++ b/examples/guides/cloud-init/native/main.tf
@@ -6,6 +6,9 @@ resource "proxmox_virtual_environment_vm" "ubuntu_vm" {
   name      = "test-ubuntu"
   node_name = "pve"
 
+  # should be true if qemu agent is not installed / enabled on the VM
+  stop_on_destroy = true
+
   initialization {
     ip_config {
       ipv4 {