This commit is contained in:
MacRimi 2025-02-16 17:45:27 +01:00
parent c9249c757d
commit 749451fcac
4 changed files with 300 additions and 24 deletions

View File

@ -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 (
<div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Install Coral TPU on the Host</h1>
<p className="mb-4">
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.
</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does This Script Do?</h2>
<p className="mb-4">When executed, this script performs the following actions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Prompts for confirmation before proceeding with the installation</li>
<li>Verifies and configures necessary repositories on the host</li>
<li>Installs required packages for driver compilation</li>
<li>Clones the Coral TPU driver repository</li>
<li>Builds and installs the Coral TPU drivers</li>
<li>Prompts for a system restart to apply changes</li>
</ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Steps</h2>
<Steps>
<Steps.Step title="Pre-Installation Prompt">
<p>The script asks for confirmation before proceeding, warning that a system restart will be required.</p>
</Steps.Step>
<Steps.Step title="Repository Configuration">
<p>Verifies and adds necessary repositories:</p>
<ul className="list-disc pl-6 space-y-1 mt-2">
<li>Adds the pve-no-subscription repository if not present</li>
<li>Adds non-free-firmware repositories to the sources list</li>
<li>Updates the package lists</li>
</ul>
</Steps.Step>
<Steps.Step title="Driver Installation">
<p>Installs Coral TPU drivers:</p>
<ul className="list-disc pl-6 space-y-1 mt-2">
<li>Installs necessary packages (git, devscripts, dh-dkms, etc.)</li>
<li>Clones the gasket-driver repository</li>
<li>Builds the driver packages</li>
<li>Installs the compiled driver packages</li>
</ul>
</Steps.Step>
<Steps.Step title="Post-Installation Prompt">
<p>Prompts the user to restart the server to apply the changes.</p>
</Steps.Step>
</Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">What to Expect</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>The script will guide you through the process with clear prompts.</li>
<li>Installation may take several minutes, depending on your system's performance.</li>
<li>A system restart is required after the installation to apply the changes.</li>
<li>After the restart, your Proxmox VE host will be ready to use Coral TPU devices.</li>
</ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>Ensure you have a stable internet connection for downloading packages and repositories.</li>
<li>
This script modifies system repositories and installs new packages. Make sure you understand the implications.
</li>
<li>The installation requires root or sudo privileges to execute.</li>
<li>It's recommended to perform a system backup before running this script.</li>
<li>If you encounter any issues during installation, check the Proxmox VE logs for more information.</li>
</ul>
<p className="mt-6 italic">
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.
</p>
{/* Add more content here */}
</div>
)
}

View File

@ -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 (
<div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Repair Network</h1>
<p className="mb-4">
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.
</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">Common Network Issues</h2>
<ul className="list-disc pl-6 space-y-2">
<li>Network interface configuration errors</li>
<li>DNS resolution problems</li>
<li>Firewall misconfiguration</li>
<li>Network bridge issues</li>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does This Script Do?</h2>
<p className="mb-4">When executed, this script offers the following main functions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Repair Network: Automatically detects and fixes common network issues</li>
<li>Verify Network: Checks the current network configuration and connectivity</li>
<li>Show IP Information: Displays IP addresses for all relevant network interfaces</li>
</ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Features</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>Detects and lists physical and network interfaces</li>
<li>Verifies and repairs bridge configurations</li>
<li>Cleans up non-existent interfaces from the configuration</li>
<li>Configures physical interfaces automatically</li>
<li>Checks network connectivity</li>
<li>Provides options to restart networking services</li>
<li>Offers an interactive menu for easy navigation</li>
</ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Steps to Repair Network</h2>
<p className="mb-4">
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.
<h2 className="text-2xl font-semibold mt-8 mb-4">How to Use</h2>
<Steps>
<Steps.Step title="Access the Network Repair Menu">
<p>Run the script and select the "Network Repair Menu" option from the main ProxMenux interface.</p>
</Steps.Step>
<Steps.Step title="Choose an Option">
<p>Select one of the following options:</p>
<ul className="list-disc pl-6 space-y-1 mt-2">
<li>Repair Network</li>
<li>Verify Network</li>
<li>Show IP Information</li>
</ul>
</Steps.Step>
<Steps.Step title="Follow the Prompts">
<p>The script will guide you through the process with clear prompts and information dialogs.</p>
</Steps.Step>
<Steps.Step title="Review Results">
<p>After each operation, review the results displayed in the dialog boxes.</p>
</Steps.Step>
<Steps.Step title="Repeat or Exit">
<p>Choose another option or return to the main menu when finished.</p>
</Steps.Step>
</Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">Repair Network Process</h2>
<p className="mb-4">When you select "Repair Network", the script performs the following actions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Detects physical network interfaces</li>
<li>Cleans up non-existent interfaces from the configuration</li>
<li>Checks and fixes bridge configurations</li>
<li>Configures physical interfaces</li>
<li>Offers to restart the networking service</li>
<li>Verifies network connectivity</li>
<li>Displays updated IP information</li>
</ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>This script requires root or sudo privileges to execute.</li>
<li>Restarting the network service may cause a brief disconnection.</li>
<li>Always ensure you have an alternative way to access your Proxmox VE system in case of network issues.</li>
<li>It's recommended to create a backup of your network configuration before making changes.</li>
<li>If you're unsure about any step, use the "Verify Network" option first to check the current status.</li>
</ul>
<p className="mt-6 italic">
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.
</p>
{/* Add more content here */}
</div>
)
}

View File

@ -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 (
<div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Disk Passthrough to a VM</h1>
<p className="mb-4">
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.
</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does This Script Do?</h2>
<p className="mb-4">When executed, this script performs the following actions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Lists available disks on the Proxmox host</li>
<li>Allows you to select a disk for passthrough</li>
<li>Lists available VMs</li>
<li>Allows you to select a VM to receive the disk passthrough</li>
<li>Configures the selected disk for passthrough</li>
<li>Adds the disk to the chosen VM's configuration</li>
</ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Steps</h2>
<Steps>
<Steps.Step title="Disk Selection">
<p>
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.
</p>
</Steps.Step>
<Steps.Step title="VM Selection">
<p>
After selecting a disk, you'll be presented with a list of available VMs. Choose the VM that should receive
the passed-through disk.
</p>
</Steps.Step>
<Steps.Step title="Disk Configuration">
<p>The script will configure the selected disk for passthrough. This involves:</p>
<ul className="list-disc pl-6 space-y-1 mt-2">
<li>Unmounting the disk if it's currently mounted</li>
<li>Removing any existing partitions or logical volumes</li>
<li>Clearing the partition table</li>
</ul>
</Steps.Step>
<Steps.Step title="VM Configuration">
<p>The script will modify the chosen VM's configuration to include the passed-through disk. This includes:</p>
<ul className="list-disc pl-6 space-y-1 mt-2">
<li>Adding the disk to the VM's configuration file</li>
<li>Setting up the appropriate SCSI controller if necessary</li>
</ul>
</Steps.Step>
</Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">What to Expect</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>The script will guide you through the process with clear prompts.</li>
<li>You'll need to make selections for both the disk and the target VM.</li>
<li>The process is typically quick, but it may take a few moments to configure larger disks.</li>
<li>After completion, the selected disk will be available to the chosen VM as a raw device.</li>
<li>You may need to restart the VM to recognize the new disk.</li>
</ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>Disk passthrough gives the VM direct access to the physical disk. Use this feature with caution.</li>
<li>
All data on the selected disk will be erased during the process. Make sure to backup any important data before
proceeding.
</li>
<li>
The disk will be exclusively used by the selected VM and will not be available to the host or other VMs.
</li>
<li>Ensure that the VM is shut down before running this script to avoid potential data corruption.</li>
<li>Some features like live migration may be limited or unavailable for VMs with passed-through disks.</li>
<li>This script requires root or sudo privileges to execute.</li>
</ul>
<p className="mt-6 italic">
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.
</p>
{/* Add more content here */}
</div>
)
}

View File

@ -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 (
<div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Import Disk Image to a VM</h1>
<p className="mb-4">
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.
</p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does This Script Do?</h2>
<p className="mb-4">When executed, this script performs the following actions:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Scans for compatible disk images (.img, .qcow2, .vmdk) in the /var/lib/vz/template/images/ directory</li>
<li>Presents a list of available VMs for selection</li>
<li>Allows you to choose one or multiple disk images for import</li>
<li>Lets you select a storage volume in Proxmox for disk placement</li>
<li>Offers options for interface type (SATA, SCSI, VirtIO, IDE) for each imported disk</li>
<li>Provides optional settings like SSD emulation and bootable disk configuration</li>
<li>Imports the selected disk images and attaches them to the chosen VM</li>
</ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Steps</h2>
<Steps>
<Steps.Step title="Preparation">
<p>
Ensure that the disk images you want to import are placed in the /var/lib/vz/template/images/ directory.
</p>
</Steps.Step>
<Steps.Step title="VM Selection">
<p>Choose the VM where you want to import the disk image(s) from a list of available VMs.</p>
</Steps.Step>
<Steps.Step title="Storage Selection">
<p>Select the Proxmox storage volume where the imported disk(s) will be placed.</p>
</Steps.Step>
<Steps.Step title="Image Selection">
<p>
Choose one or more disk images to import from the list of compatible images found in the specified
directory.
</p>
</Steps.Step>
<Steps.Step title="Configuration">
<p>For each selected image:</p>
<ul className="list-disc pl-6 space-y-1 mt-2">
<li>Choose the interface type (SATA, SCSI, VirtIO, or IDE)</li>
<li>Optionally enable SSD emulation (for non-VirtIO interfaces)</li>
<li>Decide whether to make the disk bootable</li>
</ul>
</Steps.Step>
<Steps.Step title="Import Process">
<p>The script will import each selected disk image, showing real-time progress updates.</p>
</Steps.Step>
<Steps.Step title="Finalization">
<p>After import, the script configures the disks in the VM and applies the chosen settings.</p>
</Steps.Step>
</Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">What to Expect</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>The script will guide you through the process with clear prompts and menus.</li>
<li>You'll need to make selections for the target VM, storage, disk images, and configuration options.</li>
<li>The import process may take some time, depending on the size and number of disk images.</li>
<li>Real-time progress updates will be displayed during the import process.</li>
<li>After completion, the imported disks will be available and configured in the selected VM.</li>
</ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2>
<ul className="list-disc pl-6 space-y-2 mb-6">
<li>Ensure you have sufficient storage space in the selected Proxmox storage volume before importing.</li>
<li>The script supports .img, .qcow2, and .vmdk disk image formats.</li>
<li>Make sure the VM is powered off before importing disk images to avoid potential conflicts.</li>
<li>
Importing a disk as bootable will modify the VM's boot order. Adjust the boot order in the VM settings if
necessary.
</li>
<li>SSD emulation is only available for non-VirtIO interfaces (SATA, SCSI, IDE).</li>
<li>This script requires root or sudo privileges to execute.</li>
</ul>
<p className="mt-6 italic">
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.
</p>
{/* Add more content here */}
</div>
)
}