Merge branch 'main' of https://github.com/MacRimi/ProxMenux

web/app/docs/hardware/igpu-acceleration-lxc/page.tsx

@@ -1,20 +1,124 @@
 import type { Metadata } from "next"
 
 export const metadata: Metadata = {
-  title: "HW iGPU acceleration to an LXC | ProxMenux Documentation",
-  description: "Learn how to enable hardware iGPU acceleration for an LXC container in Proxmox VE using ProxMenux.",
+  title: "Add HW iGPU acceleration to an LXC | ProxMenux Documentation",
+  description:
+    "Learn how to configure Intel iGPU acceleration for an LXC container in Proxmox VE using ProxMenux. This guide covers the setup process, required modifications, and driver installation.",
 }
 
 export default function IGPUAccelerationLXC() {
   return (
     <div className="max-w-3xl mx-auto">
-      <h1 className="text-3xl font-bold mb-6">HW iGPU acceleration to an LXC</h1>
+      <h1 className="text-3xl font-bold mb-6">Enable Intel iGPU in an LXC</h1>
       <p className="mb-4">
-        This guide will walk you through the process of enabling hardware iGPU acceleration for an LXC container in
-        Proxmox VE using ProxMenux.
+        This guide explains how to enable Intel Integrated GPU (iGPU) support in LXC containers within Proxmox VE using
+        ProxMenux. The script automates the configuration, ensuring the container has access to GPU resources for
+        hardware-accelerated tasks such as video transcoding, rendering, and OpenCL applications.
+      </p>
+
+      <h2 className="text-2xl font-bold mb-4">🔹 What This Script Does</h2>
+      <ul className="list-disc list-inside mb-4">
+        <li>Lists available LXC containers and allows the user to select one.</li>
+        <li>Validates the selected container and ensures it is properly stopped before making changes.</li>
+        <li>Configures the LXC container to enable Intel iGPU access.</li>
+        <li>Modifies the container configuration to allow GPU passthrough.</li>
+        <li>Ensures the container is privileged for proper hardware access.</li>
+        <li>Installs necessary iGPU drivers inside the container.</li>
+        <li>Sets permissions for `/dev/dri` to allow GPU access.</li>
+      </ul>
+
+      <h2 className="text-2xl font-bold mb-4">🛠️ Prerequisites</h2>
+      <ul className="list-disc list-inside mb-4">
+        <li>Proxmox VE installed and running.</li>
+        <li>An LXC container created and available.</li>
+        <li>An Intel iGPU compatible with VA-API and OpenCL.</li>
+        <li>ProxMenux installed and updated.</li>
+      </ul>
+
+      <h2 className="text-2xl font-bold mb-4">⚙️ How to Use</h2>
+      <p className="mb-4">
+        To enable Intel iGPU support for an LXC container, run the following command from ProxMenux:
+      </p>
+      <pre className="bg-gray-900 text-white p-4 rounded-md overflow-auto mb-4">
+        ./proxmenux.sh --enable-igpu
+      </pre>
+      <p className="mb-4">
+        This will launch an interactive menu where you can select an LXC container. The script will then apply the
+        necessary configurations and install required drivers.
+      </p>
+
+      <h2 className="text-2xl font-bold mb-4">🔧 Script Breakdown</h2>
+
+      <h3 className="text-xl font-semibold mt-4 mb-2">1️⃣ Select an LXC Container</h3>
+      <p className="mb-4">
+        The script lists all available LXC containers and allows the user to choose one. If no container is selected or
+        available, it exits with an error.
+      </p>
+
+      <h3 className="text-xl font-semibold mt-4 mb-2">2️⃣ Validate and Stop the Container</h3>
+      <p className="mb-4">
+        Before applying modifications, the script ensures that the container is stopped. If it is running, it is
+        automatically stopped to prevent conflicts.
+      </p>
+
+      <h3 className="text-xl font-semibold mt-4 mb-2">3️⃣ Configure the LXC Container</h3>
+      <p className="mb-4">
+        The script modifies the container configuration file (`/etc/pve/lxc/[ID].conf`) to:
+      </p>
+      <ul className="list-disc list-inside mb-4">
+        <li>Ensure the container is **privileged**.</li>
+        <li>Add GPU-related permissions (`cgroup2.devices.allow`).</li>
+        <li>Mount `/dev/dri` and `/dev/fb0` for GPU access.</li>
+      </ul>
+
+      <h3 className="text-xl font-semibold mt-4 mb-2">4️⃣ Install iGPU Drivers</h3>
+      <p className="mb-4">
+        The script starts the container and installs essential Intel iGPU drivers, including:
+      </p>
+      <pre className="bg-gray-900 text-white p-4 rounded-md overflow-auto mb-4">
+        apt-get install -y va-driver-all ocl-icd-libopencl1 intel-opencl-icd vainfo intel-gpu-tools
+      </pre>
+      <p className="mb-4">
+        It also ensures that necessary user permissions are applied for access to `/dev/dri`.
+      </p>
+
+      <h2 className="text-2xl font-bold mb-4">🎯 Expected Outcome</h2>
+      <p className="mb-4">
+        Once the script finishes, the LXC container will have Intel iGPU access enabled, allowing applications inside
+        the container to leverage hardware acceleration for graphics and compute tasks.
+      </p>
+
+      <h2 className="text-2xl font-bold mb-4">📌 Notes</h2>
+      <ul className="list-disc list-inside mb-4">
+        <li>This script modifies the LXC container's configuration. Always back up your settings before proceeding.</li>
+        <li>Ensure that your Proxmox host has the necessary drivers installed for Intel iGPU support.</li>
+        <li>For troubleshooting, check logs inside the container after running the script.</li>
+      </ul>
+
+      <h2 className="text-2xl font-bold mb-4">📖 Additional Resources</h2>
+      <ul className="list-disc list-inside mb-4">
+        <li>
+          <a href="https://pve.proxmox.com/wiki/Linux_Containers" className="text-blue-400 hover:underline">
+            Proxmox LXC Documentation
+          </a>
+        </li>
+        <li>
+          <a href="https://pve.proxmox.com/wiki/PCI_Passthrough" className="text-blue-400 hover:underline">
+            PCI Passthrough Guide
+          </a>
+        </li>
+      </ul>
+
+      <p className="text-gray-400 mt-6">
+        If you encounter issues or have suggestions, consider contributing to the
+        <a
+          href="https://github.com/MacRimi/ProxMenux"
+          className="text-blue-400 hover:underline ml-1"
+        >
+          ProxMenux GitHub repository
+        </a>
+        .
       </p>
-      {/* Add more content here */}
     </div>
   )
 }
-