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 fcf563c..ddbfcaa 100644
--- a/web/app/docs/hardware/install-coral-tpu-host/page.tsx
+++ b/web/app/docs/hardware/install-coral-tpu-host/page.tsx
@@ -1,18 +1,84 @@
import type { Metadata } from "next"
+import { Steps } from "@/components/ui/steps"
export const metadata: Metadata = {
title: "Install Coral TPU on the Host | ProxMenux Documentation",
- description: "Learn how to install a Coral TPU on the Proxmox VE host using ProxMenux.",
+ description: "Learn how to install Coral TPU drivers on your Proxmox VE host.",
}
export default function InstallCoralTPUHost() {
return (
Install Coral TPU on the Host
+
- This guide will walk you through the process of installing a Coral TPU on your Proxmox VE host using ProxMenux.
+ This script automates the installation of Google Coral TPU (Tensor Processing Unit) drivers on your Proxmox VE
+ host. It ensures that all necessary packages are installed and compiles the Coral TPU drivers for proper
+ functionality.
+
+
+
What Does This Script Do?
+
When executed, this script performs the following actions:
+
+ - Prompts for confirmation before proceeding with the installation
+ - Verifies and configures necessary repositories on the host
+ - Installs required packages for driver compilation
+ - Clones the Coral TPU driver repository
+ - Builds and installs the Coral TPU drivers
+ - Prompts for a system restart to apply changes
+
+
+
Key Steps
+
+
+ The script asks for confirmation before proceeding, warning that a system restart will be required.
+
+
+ Verifies and adds necessary repositories:
+
+ - Adds the pve-no-subscription repository if not present
+ - Adds non-free-firmware repositories to the sources list
+ - Updates the package lists
+
+
+
+ Installs Coral TPU drivers:
+
+ - Installs necessary packages (git, devscripts, dh-dkms, etc.)
+ - Clones the gasket-driver repository
+ - Builds the driver packages
+ - Installs the compiled driver packages
+
+
+
+ Prompts the user to restart the server to apply the changes.
+
+
+
+
What to Expect
+
+ - The script will guide you through the process with clear prompts.
+ - Installation may take several minutes, depending on your system's performance.
+ - A system restart is required after the installation to apply the changes.
+ - After the restart, your Proxmox VE host will be ready to use Coral TPU devices.
+
+
+
Important Notes
+
+ - Ensure you have a stable internet connection for downloading packages and repositories.
+ -
+ This script modifies system repositories and installs new packages. Make sure you understand the implications.
+
+ - The installation requires root or sudo privileges to execute.
+ - It's recommended to perform a system backup before running this script.
+ - If you encounter any issues during installation, check the Proxmox VE logs for more information.
+
+
+
+ This script simplifies the process of installing Coral TPU drivers on your Proxmox VE host, enabling you to use
+ Coral TPU devices for AI and machine learning tasks. After installation and restart, you can proceed to
+ configure individual LXC containers or VMs to use the Coral TPU.
- {/* Add more content here */}
)
}
diff --git a/web/app/docs/network/repair-network/page.tsx b/web/app/docs/network/repair-network/page.tsx
index 85fe5cc..6aa5937 100644
--- a/web/app/docs/network/repair-network/page.tsx
+++ b/web/app/docs/network/repair-network/page.tsx
@@ -1,30 +1,90 @@
import type { Metadata } from "next"
+import { Steps } from "@/components/ui/steps"
export const metadata: Metadata = {
title: "Repair Network | ProxMenux Documentation",
- description: "Learn how to repair network issues in Proxmox VE using ProxMenux.",
+ description: "Learn how to repair and verify network configurations in Proxmox VE using ProxMenux.",
}
export default function RepairNetwork() {
return (
Repair Network
+
- This guide will walk you through the process of repairing network issues in Proxmox VE using ProxMenux.
+ This script provides comprehensive network repair and verification functionality for Proxmox VE systems. It
+ helps users troubleshoot and fix common network issues, ensuring stable connectivity and proper configuration.
-
Common Network Issues
-
- - Network interface configuration errors
- - DNS resolution problems
- - Firewall misconfiguration
- - Network bridge issues
+
+ What Does This Script Do?
+ When executed, this script offers the following main functions:
+
+ - Repair Network: Automatically detects and fixes common network issues
+ - Verify Network: Checks the current network configuration and connectivity
+ - Show IP Information: Displays IP addresses for all relevant network interfaces
+
+
+ Key Features
+
+ - Detects and lists physical and network interfaces
+ - Verifies and repairs bridge configurations
+ - Cleans up non-existent interfaces from the configuration
+ - Configures physical interfaces automatically
+ - Checks network connectivity
+ - Provides options to restart networking services
+ - Offers an interactive menu for easy navigation
- Steps to Repair Network
-
- Detailed steps for repairing network issues will be provided here. This may include commands to run,
- configuration files to check, and best practices to follow.
+
+
How to Use
+
+
+ Run the script and select the "Network Repair Menu" option from the main ProxMenux interface.
+
+
+ Select one of the following options:
+
+ - Repair Network
+ - Verify Network
+ - Show IP Information
+
+
+
+ The script will guide you through the process with clear prompts and information dialogs.
+
+
+ After each operation, review the results displayed in the dialog boxes.
+
+
+ Choose another option or return to the main menu when finished.
+
+
+
+ Repair Network Process
+ When you select "Repair Network", the script performs the following actions:
+
+ - Detects physical network interfaces
+ - Cleans up non-existent interfaces from the configuration
+ - Checks and fixes bridge configurations
+ - Configures physical interfaces
+ - Offers to restart the networking service
+ - Verifies network connectivity
+ - Displays updated IP information
+
+
+ Important Notes
+
+ - This script requires root or sudo privileges to execute.
+ - Restarting the network service may cause a brief disconnection.
+ - Always ensure you have an alternative way to access your Proxmox VE system in case of network issues.
+ - It's recommended to create a backup of your network configuration before making changes.
+ - If you're unsure about any step, use the "Verify Network" option first to check the current status.
+
+
+
+ This script simplifies the process of troubleshooting and repairing network issues in Proxmox VE. It provides an
+ easy-to-use interface for common network maintenance tasks, helping to ensure your Proxmox system maintains
+ stable connectivity.
- {/* Add more content here */}
)
}
diff --git a/web/app/docs/storage/disk-passthrough-vm/page.tsx b/web/app/docs/storage/disk-passthrough-vm/page.tsx
index 1c02f58..be32e40 100644
--- a/web/app/docs/storage/disk-passthrough-vm/page.tsx
+++ b/web/app/docs/storage/disk-passthrough-vm/page.tsx
@@ -1,19 +1,93 @@
import type { Metadata } from "next"
+import { Steps } from "@/components/ui/steps"
export const metadata: Metadata = {
title: "Disk Passthrough to a VM | ProxMenux Documentation",
- description: "Learn how to set up disk passthrough to a virtual machine in Proxmox VE using ProxMenux.",
+ description: "Learn how to set up disk passthrough to a virtual machine in Proxmox VE.",
}
export default function DiskPassthroughVM() {
return (
Disk Passthrough to a VM
+
- This guide will walk you through the process of setting up disk passthrough to a virtual machine in Proxmox VE
- using ProxMenux.
+ 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.
+
+
+
What Does This Script Do?
+
When executed, this script performs the following actions:
+
+ - 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
+
+
+
Key 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.
+
+
+
+
+ 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 script will configure the selected disk for passthrough. This involves:
+
+ - Unmounting the disk if it's currently mounted
+ - Removing any existing partitions or logical volumes
+ - Clearing the partition table
+
+
+
+ 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
+
+
+
+
+
What to Expect
+
+ - 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.
+
+
+
Important Notes
+
+ - 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.
+
+
+
+ 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.
- {/* Add more content here */}
)
}
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 b90ab2a..18cf26a 100644
--- a/web/app/docs/storage/import-disk-image-vm/page.tsx
+++ b/web/app/docs/storage/import-disk-image-vm/page.tsx
@@ -1,19 +1,95 @@
import type { Metadata } from "next"
+import { Steps } from "@/components/ui/steps"
export const metadata: 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 using ProxMenux.",
+ description: "Learn how to import a disk image to a virtual machine in Proxmox VE.",
}
export default function ImportDiskImageVM() {
return (
Import Disk Image to a VM
+
- This guide will walk you through the process of importing a disk image to a virtual machine in Proxmox VE using
- ProxMenux.
+ 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.
+
+
+
What Does This Script Do?
+
When executed, this script performs the following actions:
+
+ - 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
+
+
+
Key Steps
+
+
+
+ Ensure that the disk images you want to import are placed in the /var/lib/vz/template/images/ directory.
+
+
+
+ Choose the VM where you want to import the disk image(s) from a list of available VMs.
+
+
+ Select 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.
+
+
+
+ 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
+
+
+
+ The script will import each selected disk image, showing real-time progress updates.
+
+
+ After import, the script configures the disks in the VM and applies the chosen settings.
+
+
+
+
What to Expect
+
+ - 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.
+
+
+
Important Notes
+
+ - 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.
+
+ - SSD emulation is only available for non-VirtIO interfaces (SATA, SCSI, IDE).
+ - This script requires root or sudo privileges to execute.
+
+
+
+ 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.
- {/* Add more content here */}
)
}