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:

    -
  1. Scans for disk images (.img, .qcow2, .vmdk) in /var/lib/vz/template/images/.
  2. +
  3. Lists available physical disks on the Proxmox host, excluding the system disk.
  4. Displays a list of available virtual machines (VMs) for selection.
  5. -
  6. Allows users to choose one or multiple disk images for import.
  7. -
  8. Provides storage volume options for placing the imported disk.
  9. -
  10. Offers an interface choice (SATA, SCSI, VirtIO, or IDE) for each imported disk.
  11. -
  12. Imports and attaches the selected disk images to the chosen VM.
  13. +
  14. Allows the user to select multiple disks to assign to a VM.
  15. +
  16. Ensures selected disks are not already in use by another VM.
  17. +
  18. 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/.

+ + Disk Selection Menu +

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:

+ + Disk Assigment Menu +

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

Important Considerations

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:

    -
  1. Scans for compatible disk images (.img, .qcow2, .vmdk) in the /var/lib/vz/template/images/ directory
  2. -
  3. Presents a list of available VMs for selection
  4. -
  5. Allows you to choose one or multiple disk images for import
  6. -
  7. Lets you select a storage volume in Proxmox for disk placement
  8. -
  9. Offers options for interface type (SATA, SCSI, VirtIO, IDE) for each imported disk
  10. -
  11. Provides optional settings like SSD emulation and bootable disk configuration
  12. -
  13. Imports the selected disk images and attaches them to the chosen VM
  14. +
  15. Scans for disk images (.img, .qcow2, .vmdk) in /var/lib/vz/template/images/.
  16. +
  17. Displays a list of available virtual machines (VMs) for selection.
  18. +
  19. Allows users to choose one or multiple disk images for import.
  20. +
  21. Provides storage volume options for placing the imported disk.
  22. +
  23. Offers an interface choice (SATA, SCSI, VirtIO, or IDE) for each imported disk.
  24. +
  25. 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

- -

Important Notes

+ +

Important Considerations

- -

- 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. -

+
) } -