diff --git a/web/app/docs/storage/disk-passthrough-vm/page.tsx b/web/app/docs/storage/disk-passthrough-vm/page.tsx
index fb377f4..8aa3b47 100644
--- a/web/app/docs/storage/disk-passthrough-vm/page.tsx
+++ b/web/app/docs/storage/disk-passthrough-vm/page.tsx
@@ -2,65 +2,75 @@ import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata = {
- title: "Disk Passthrough to a VM | ProxMenux Documentation",
- description: "Step-by-step guide to configure disk passthrough to a virtual machine in Proxmox VE using ProxMenux.",
+ title: "Import Disk Image to a VM | ProxMenux Documentation",
+ description: "Step-by-step guide to import a disk image into a virtual machine in Proxmox VE using ProxMenux.",
}
-export default function DiskPassthroughVM() {
+export default function ImportDiskImageVM() {
return (
-
Disk Passthrough to a VM
+
Import Disk Image to a VM
- This guide explains how to assign physical disks to virtual machines (VMs) in Proxmox VE using ProxMenux.
- Disk passthrough allows a VM to have direct access to a physical disk, providing improved performance and compatibility for certain applications.
+ This guide explains how to import a disk image into a virtual machine (VM) in Proxmox VE using ProxMenux.
+ The script simplifies the process by scanning for available disk images and allowing users to attach them to VMs without manual configuration.
Overview
The script automates the following steps:
- - Lists available physical disks on the Proxmox host, excluding the system disk.
+ - Scans for disk images (.img, .qcow2, .vmdk) in
/var/lib/vz/template/images/
.
- Displays a list of available virtual machines (VMs) for selection.
- - Allows the user to select multiple disks to assign to a VM.
- - Ensures selected disks are not already in use by another VM.
- - Configures the selected disks for passthrough to the chosen VM.
+ - Allows users to choose one or multiple disk images for import.
+ - Provides storage volume options for placing the imported disk.
+ - Offers an interface choice (SATA, SCSI, VirtIO, or IDE) for each imported disk.
+ - Imports and attaches the selected disk images to the chosen VM.
Implementation Steps
-
-
- The script scans the system and displays a list of available physical disks, excluding the system disk.
+
+ Ensure that the disk images you want to import are placed in /var/lib/vz/template/images/
.
- The user selects the virtual machine (VM) to which the disk(s) will be assigned.
+ Select the VM where the disk image(s) will be imported.
-
- The script performs the following actions:
+
+ Choose the Proxmox storage volume where the imported disk(s) will be placed.
+
+
+ Select one or more disk images to import from the list of detected compatible images.
+
+
+ For each selected image:
- - Ensures the selected disk is not in use by another VM.
- - Provides an interface choice (SATA, SCSI, VirtIO, or IDE).
- - Automatically configures the disk passthrough and assigns it to the VM.
+ - Choose the interface type (SATA, SCSI, VirtIO, or IDE).
+ - Optionally enable SSD emulation (for non-VirtIO interfaces).
+ - Decide whether to make the disk bootable.
-
- The script verifies the operation and confirms the successful disk passthrough.
+
+ The script will import each selected disk image and display real-time progress updates.
+
+
+ After the import is complete, the script attaches the disks to the VM and applies the selected settings.
Expected Results
- - The selected physical disk(s) are successfully assigned to the specified VM.
- - Users are provided with a confirmation of the disk assignment.
- - The VM is configured to recognize the disk(s) upon startup.
+ - The selected disk images are successfully imported and attached to the specified VM.
+ - Users receive confirmation of the import operation.
+ - The VM is configured to recognize the new disks upon startup.
Important Considerations
- - The script requires root privileges to execute.
- - Ensure the selected disk is not already in use by another VM.
- - VMs must be powered off before adding disks to prevent data corruption.
- - Using disk passthrough limits certain VM features, such as live migration.
+ - Ensure you have sufficient storage space in the selected Proxmox storage volume.
+ - Supported disk image formats include
.img
, .qcow2
, and .vmdk
.
+ - The target VM must be powered off before importing disk images.
+ - SSD emulation is only available for non-VirtIO interfaces (SATA, SCSI, IDE).
+ - Importing a disk as bootable will modify the VM’s boot order. Adjust boot settings as needed.
diff --git a/web/public/disk/disk-assigment.png b/web/public/disk/disk-assigment.png
new file mode 100644
index 0000000..9bf015c
Binary files /dev/null and b/web/public/disk/disk-assigment.png differ