diff --git a/web/app/docs/storage/disk-passthrough-vm/page.tsx b/web/app/docs/storage/disk-passthrough-vm/page.tsx
index 8aa3b47..1cbd84b 100644
--- a/web/app/docs/storage/disk-passthrough-vm/page.tsx
+++ b/web/app/docs/storage/disk-passthrough-vm/page.tsx
@@ -2,75 +2,65 @@ import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata = {
- 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.",
+ 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.",
}
-export default function ImportDiskImageVM() {
+export default function DiskPassthroughVM() {
return (
-
Import Disk Image to a VM
+
Disk Passthrough to a VM
- 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.
+ 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.
Overview
The script automates the following steps:
- - Scans for disk images (.img, .qcow2, .vmdk) in
/var/lib/vz/template/images/
.
+ - Lists available physical disks on the Proxmox host, excluding the system disk.
- Displays a list of available virtual machines (VMs) for selection.
- - 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.
+ - 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.
Implementation Steps
-
- Ensure that the disk images you want to import are placed in /var/lib/vz/template/images/
.
+
+
+ The script scans the system and displays a list of available physical disks, excluding the system disk.
- Select the VM where the disk image(s) will be imported.
+ The user selects the virtual machine (VM) to which the disk(s) will be assigned.
-
- 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:
+
+
+ The script performs the following actions:
- - Choose the interface type (SATA, SCSI, VirtIO, or IDE).
- - Optionally enable SSD emulation (for non-VirtIO interfaces).
- - Decide whether to make the disk bootable.
+ - 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.
-
- 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.
+
+ The script verifies the operation and confirms the successful disk passthrough.
Expected Results
- - 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.
+ - 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.
Important Considerations
- - 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.
+ - 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.
diff --git a/web/app/docs/storage/import-disk-image-vm/page.tsx b/web/app/docs/storage/import-disk-image-vm/page.tsx
index 18cf26a..011deb3 100644
--- a/web/app/docs/storage/import-disk-image-vm/page.tsx
+++ b/web/app/docs/storage/import-disk-image-vm/page.tsx
@@ -1,96 +1,78 @@
-import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps"
+import CopyableCode from "@/components/CopyableCode"
-export const metadata: Metadata = {
+export const metadata = {
title: "Import Disk Image to a VM | ProxMenux Documentation",
- description: "Learn how to import a disk image to a virtual machine in Proxmox VE.",
+ description: "Step-by-step guide to import a disk image into a virtual machine in Proxmox VE using ProxMenux.",
}
export default function ImportDiskImageVM() {
return (
Import Disk Image to a VM
-
+
- This script automates the process of importing disk images into Proxmox VE virtual machines (VMs). It simplifies
- the task of attaching pre-existing disk files to VMs without requiring manual configuration.
+ 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.
-
-
What Does This Script Do?
-
When executed, this script performs the following actions:
+
+
Overview
+
The script automates the following steps:
- - Scans for compatible disk images (.img, .qcow2, .vmdk) in the /var/lib/vz/template/images/ directory
- - Presents a list of available VMs for selection
- - Allows you to choose one or multiple disk images for import
- - Lets you select a storage volume in Proxmox for disk placement
- - Offers options for interface type (SATA, SCSI, VirtIO, IDE) for each imported disk
- - Provides optional settings like SSD emulation and bootable disk configuration
- - Imports the selected disk images and attaches them to the chosen VM
+ - Scans for disk images (.img, .qcow2, .vmdk) in
/var/lib/vz/template/images/
.
+ - Displays a list of available virtual machines (VMs) for selection.
+ - 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.
-
-
Key Steps
+
+
Implementation Steps
-
- Ensure that the disk images you want to import are placed in the /var/lib/vz/template/images/ directory.
-
+ Ensure that the disk images you want to import are placed in /var/lib/vz/template/images/
.
- Choose the VM where you want to import the disk image(s) from a list of available VMs.
+ Select the VM where the disk image(s) will be imported.
- Select the Proxmox storage volume where the imported disk(s) will be placed.
+ Choose the Proxmox storage volume where the imported disk(s) will be placed.
-
- Choose one or more disk images to import from the list of compatible images found in the specified
- directory.
-
+ Select one or more disk images to import from the list of detected compatible images.
For each selected image:
- - Choose the interface type (SATA, SCSI, VirtIO, or IDE)
- - Optionally enable SSD emulation (for non-VirtIO interfaces)
- - Decide whether to make the disk bootable
+ - 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 will import each selected disk image, showing real-time progress updates.
+ The script will import each selected disk image and display real-time progress updates.
- After import, the script configures the disks in the VM and applies the chosen settings.
+ After the import is complete, the script attaches the disks to the VM and applies the selected settings.
-
-
What to Expect
+
+
Expected Results
- - The script will guide you through the process with clear prompts and menus.
- - You'll need to make selections for the target VM, storage, disk images, and configuration options.
- - The import process may take some time, depending on the size and number of disk images.
- - Real-time progress updates will be displayed during the import process.
- - After completion, the imported disks will be available and configured in the selected VM.
+ - 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 Notes
+
+
Important Considerations
- - Ensure you have sufficient storage space in the selected Proxmox storage volume before importing.
- - The script supports .img, .qcow2, and .vmdk disk image formats.
- - Make sure the VM is powered off before importing disk images to avoid potential conflicts.
- -
- Importing a disk as bootable will modify the VM's boot order. Adjust the boot order in the VM settings if
- necessary.
-
+ - 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).
- - This script requires root or sudo privileges to execute.
+ - Importing a disk as bootable will modify the VM’s boot order. Adjust boot settings as needed.
-
-
- This script simplifies the process of importing disk images to VMs in Proxmox VE, making it easy to add
- pre-existing disks or migrate disks from other environments. It handles the technical details of import and
- configuration, allowing you to quickly add new storage to your VMs.
-
+
)
}
-