diff --git a/web/app/docs/hardware/install-coral-tpu-host/page.tsx b/web/app/docs/hardware/install-coral-tpu-host/page.tsx
index 572b0f9..dc4be4c 100644
--- a/web/app/docs/hardware/install-coral-tpu-host/page.tsx
+++ b/web/app/docs/hardware/install-coral-tpu-host/page.tsx
@@ -59,20 +59,9 @@ export default function InstallCoralTPUHost() {
The Coral TPU drivers are installed successfully on the Proxmox VE host.
Required repositories and dependencies are configured properly.
A system restart is performed to complete the installation.
- After the restart, the host is ready to utilize Coral TPU for AI workloads.
- Important Considerations
-
- - A stable internet connection is required to fetch repositories and dependencies.
- - This script modifies system repositories and installs new packages.
- - Root or sudo privileges are required to execute the script.
- - It's recommended to create a system backup before running the script.
-
-
-
- By using ProxMenux, Coral TPU drivers can be installed on a Proxmox VE host efficiently, avoiding manual setup and potential configuration issues.
-
+
)
}
diff --git a/web/app/docs/storage/disk-passthrough-vm/page.tsx b/web/app/docs/storage/disk-passthrough-vm/page.tsx
index be32e40..fb377f4 100644
--- a/web/app/docs/storage/disk-passthrough-vm/page.tsx
+++ b/web/app/docs/storage/disk-passthrough-vm/page.tsx
@@ -1,94 +1,69 @@
-import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps"
+import CopyableCode from "@/components/CopyableCode"
-export const metadata: Metadata = {
+export const metadata = {
title: "Disk Passthrough to a VM | ProxMenux Documentation",
- description: "Learn how to set up disk passthrough to a virtual machine in Proxmox VE.",
+ description: "Step-by-step guide to configure disk passthrough to a virtual machine in Proxmox VE using ProxMenux.",
}
export default function DiskPassthroughVM() {
return (
Disk Passthrough to a VM
-
+
- This script automates the process of setting up disk passthrough to a virtual machine (VM) in Proxmox VE. Disk
- passthrough allows a VM to have direct access to a physical disk or partition, which can be useful for certain
- applications that require low-level disk access or for maximizing storage performance.
+ 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.
-
-
What Does This Script Do?
-
When executed, this script performs the following actions:
+
+
Overview
+
The script automates the following steps:
- - Lists available disks on the Proxmox host
- - Allows you to select a disk for passthrough
- - Lists available VMs
- - Allows you to select a VM to receive the disk passthrough
- - Configures the selected disk for passthrough
- - Adds the disk to the chosen VM's configuration
+ - Lists available physical disks on the Proxmox host, excluding the system disk.
+ - 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.
-
-
Key Steps
+
+
Implementation Steps
-
- The script will display a list of available disks on your Proxmox host. You'll be prompted to select the
- disk you want to pass through to a VM.
-
+
+ The script scans the system and displays a list of available physical disks, excluding the system disk.
-
- After selecting a disk, you'll be presented with a list of available VMs. Choose the VM that should receive
- the passed-through disk.
-
+ The user selects the virtual machine (VM) to which the disk(s) will be assigned.
-
- The script will configure the selected disk for passthrough. This involves:
+
+ The script performs the following actions:
- - Unmounting the disk if it's currently mounted
- - Removing any existing partitions or logical volumes
- - Clearing the partition table
+ - 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 modify the chosen VM's configuration to include the passed-through disk. This includes:
-
- - Adding the disk to the VM's configuration file
- - Setting up the appropriate SCSI controller if necessary
-
+
+ The script verifies the operation and confirms the successful disk passthrough.
-
-
What to Expect
+
+
Expected Results
- - The script will guide you through the process with clear prompts.
- - You'll need to make selections for both the disk and the target VM.
- - The process is typically quick, but it may take a few moments to configure larger disks.
- - After completion, the selected disk will be available to the chosen VM as a raw device.
- - You may need to restart the VM to recognize the new disk.
+ - 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 Notes
+
+
Important Considerations
- - Disk passthrough gives the VM direct access to the physical disk. Use this feature with caution.
- -
- All data on the selected disk will be erased during the process. Make sure to backup any important data before
- proceeding.
-
- -
- The disk will be exclusively used by the selected VM and will not be available to the host or other VMs.
-
- - Ensure that the VM is shut down before running this script to avoid potential data corruption.
- - Some features like live migration may be limited or unavailable for VMs with passed-through disks.
- - This script requires root or sudo privileges to execute.
+ - 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.
+
-
- This script simplifies the process of setting up disk passthrough in Proxmox VE, allowing you to easily assign
- physical disks to specific VMs. This can be particularly useful for applications that require direct disk access
- or for maximizing storage performance in certain scenarios.
-
)
}
-
diff --git a/web/public/disk/disk-selection.png b/web/public/disk/disk-selection.png
new file mode 100644
index 0000000..6d54707
Binary files /dev/null and b/web/public/disk/disk-selection.png differ