Mirrors/ProxMenux
1
0
Fork 0
mirror of https://github.com/MacRimi/ProxMenux.git synced 2025-06-28 04:06:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update

Browse Source
This commit is contained in:
MacRimi 2025-03-04 18:14:07 +01:00
parent ef76b915f9
commit 2d9ef1a2fe
1 changed files with 45 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
web/app/docs/hardware/install-coral-tpu-host/page.tsx
View File

@ -1,85 +1,78 @@
import type { Metadata } from "next"
import { Steps } from "@/components/ui/steps" import { Steps } from "@/components/ui/steps"
import CopyableCode from "@/components/CopyableCode"
export const metadata: Metadata = { export const metadata = {
title: "Install Coral TPU on the Host | ProxMenux Documentation", title: "Install Coral TPU on the Host | ProxMenux Documentation",
description: "Learn how to install Coral TPU drivers on your Proxmox VE host.", description: "Step-by-step guide to install Google Coral TPU drivers on a Proxmox VE host using ProxMenux.",
} }
export default function InstallCoralTPUHost() { export default function InstallCoralTPUHost() {
return ( return (
<div className="max-w-3xl mx-auto"> <div className="max-w-3xl mx-auto">
<h1 className="text-3xl font-bold mb-6">Install Coral TPU on the Host</h1> <h1 className="text-3xl font-bold mb-6">Install Coral TPU on the Host</h1>
<p className="mb-4"> <p className=\"mb-4\"><strong>Before using Coral TPU inside an LXC container, the drivers must first be installed on the Proxmox VE host. This script automates that process, ensuring the necessary setup is completed.</strong><br/><br/>
This script automates the installation of Google Coral TPU (Tensor Processing Unit) drivers on your Proxmox VE This guide explains how to install and configure Google Coral TPU drivers on a Proxmox VE host using <strong>ProxMenux</strong>.
host. It ensures that all necessary packages are installed and compiles the Coral TPU drivers for proper This setup enables hardware acceleration for AI-based applications that leverage Coral TPU.
functionality.
</p> </p>
<h2 className="text-2xl font-semibold mt-8 mb-4">What Does This Script Do?</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Overview</h2>
<p className="mb-4">When executed, this script performs the following actions:</p> <p className="mb-4">The script automates the following steps:</p>
<ol className="list-decimal pl-6 space-y-2 mb-6"> <ol className="list-decimal pl-6 space-y-2 mb-6">
<li>Prompts for confirmation before proceeding with the installation</li> <li>Prompts for confirmation before proceeding with installation.</li>
<li>Verifies and configures necessary repositories on the host</li> <li>Verifies and configures necessary repositories on the host.</li>
<li>Installs required packages for driver compilation</li> <li>Installs required dependencies for driver compilation.</li>
<li>Clones the Coral TPU driver repository</li> <li>Clones the Coral TPU driver repository and builds the drivers.</li>
<li>Builds and installs the Coral TPU drivers</li> <li>Installs the compiled Coral TPU drivers.</li>
<li>Prompts for a system restart to apply changes</li> <li>Prompts for a system restart to apply changes.</li>
</ol> </ol>
<h2 className="text-2xl font-semibold mt-8 mb-4">Key Steps</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Implementation Steps</h2>
<Steps> <Steps>
<Steps.Step title="Pre-Installation Prompt"> <Steps.Step title="Pre-Installation Confirmation">
<p>The script asks for confirmation before proceeding, warning that a system restart will be required.</p> <p>The script prompts the user for confirmation before proceeding, as a system restart is required after installation.</p>
</Steps.Step> </Steps.Step>
<Steps.Step title="Repository Configuration"> <Steps.Step title="Repository Configuration">
<p>Verifies and adds necessary repositories:</p> <p>The script verifies and configures required repositories:</p>
<ul className="list-disc pl-6 space-y-1 mt-2"> <ul className="list-disc pl-6 space-y-1 mt-2">
<li>Adds the pve-no-subscription repository if not present</li> <li>Adds the <strong>pve-no-subscription</strong> repository if not present.</li>
<li>Adds non-free-firmware repositories to the sources list</li> <li>Adds <strong>non-free-firmware</strong> repositories for required packages.</li>
<li>Updates the package lists</li> <li>Runs an update to fetch the latest package lists.</li>
</ul> </ul>
</Steps.Step> </Steps.Step>
<Steps.Step title="Driver Installation"> <Steps.Step title="Driver Installation">
<p>Installs Coral TPU drivers:</p> <p>The script installs and compiles the required drivers:</p>
<ul className="list-disc pl-6 space-y-1 mt-2"> <ul className="list-disc pl-6 space-y-1 mt-2">
<li>Installs necessary packages (git, devscripts, dh-dkms, etc.)</li> <li>Installs dependencies such as <strong>git, dkms, devscripts</strong>, and kernel headers.</li>
<li>Clones the gasket-driver repository</li> <li>Clones the <strong>gasket-driver</strong> repository from Google.</li>
<li>Builds the driver packages</li> <li>Builds the Coral TPU driver packages.</li>
<li>Installs the compiled driver packages</li> <li>Installs the compiled drivers on the host.</li>
</ul> </ul>
</Steps.Step> </Steps.Step>
<Steps.Step title="Post-Installation Prompt"> <Steps.Step title="Post-Installation Confirmation">
<p>Prompts the user to restart the server to apply the changes.</p> <p>The script prompts the user to restart the server to apply the changes.</p>
</Steps.Step> </Steps.Step>
</Steps> </Steps>
<h2 className="text-2xl font-semibold mt-8 mb-4">What to Expect</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Expected Results</h2>
<ul className="list-disc pl-6 space-y-2 mb-6"> <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>The Coral TPU drivers are installed successfully on the Proxmox VE host.</li>
<li>Installation may take several minutes, depending on your system's performance.</li> <li>Required repositories and dependencies are configured properly.</li>
<li>A system restart is required after the installation to apply the changes.</li> <li>A system restart is performed to complete the installation.</li>
<li>After the restart, your Proxmox VE host will be ready to use Coral TPU devices.</li> <li>After the restart, the host is ready to utilize Coral TPU for AI workloads.</li>
</ul> </ul>
<h2 className="text-2xl font-semibold mt-8 mb-4">Important Notes</h2> <h2 className="text-2xl font-semibold mt-8 mb-4">Important Considerations</h2>
<ul className="list-disc pl-6 space-y-2 mb-6"> <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>A stable internet connection is required to fetch repositories and dependencies.</li>
<li> <li>This script modifies system repositories and installs new packages.</li>
This script modifies system repositories and installs new packages. Make sure you understand the implications. <li>Root or sudo privileges are required to execute the script.</li>
</li> <li>It's recommended to create a system backup before running the script.</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> </ul>
<p className="mt-6 italic"> <p className="mt-6 italic">
This script simplifies the process of installing Coral TPU drivers on your Proxmox VE host, enabling you to use By using ProxMenux, Coral TPU drivers can be installed on a Proxmox VE host efficiently, avoiding manual setup and potential configuration issues.
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> </p>
</div> </div>
) )
} }