diff --git a/web/app/docs/hardware/igpu-acceleration-lxc/page.tsx b/web/app/docs/hardware/igpu-acceleration-lxc/page.tsx index 085219c..7f9bac1 100644 --- a/web/app/docs/hardware/igpu-acceleration-lxc/page.tsx +++ b/web/app/docs/hardware/igpu-acceleration-lxc/page.tsx @@ -1,76 +1,80 @@ -import type { Metadata } from "next" -import { Steps } from "@/components/ui/steps" +"use client" -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.", +import { Steps } from "@/components/ui/steps" +import CopyableCode from "@/components/CopyableCode" +import Image from "next/image" + +export const metadata = { + title: "Enable iGPU Acceleration in LXC | ProxMenux Documentation", + description: "Step-by-step guide to enable Intel iGPU acceleration in an LXC container using ProxMenux.", } export default function IGPUAccelerationLXC() { return (
-

HW iGPU Acceleration to an LXC

- +

Enable Intel iGPU Acceleration in an LXC

+

- This guide explains how ProxMenux helps you enable Intel Integrated GPU (iGPU) acceleration for LXC containers - in Proxmox VE. This feature allows your containers to use the host's Intel GPU for tasks like video transcoding, - rendering, and accelerating graphics-intensive applications. + This guide explains how to configure Intel Integrated GPU (iGPU) acceleration for LXC containers in Proxmox VE + using ProxMenux. Enabling iGPU support allows containers to use the host’s GPU for hardware acceleration + in applications such as video transcoding and rendering.

- -

What Does This Script Do?

-

When you run this script through ProxMenux, it performs the following actions:

+ +

Overview of the Process

+

When you run this script in ProxMenux, it performs the following steps:

    -
  1. Presents a list of your LXC containers for you to choose from
  2. -
  3. Configures the selected container to support iGPU acceleration
  4. -
  5. Installs necessary drivers and tools inside the container
  6. +
  7. Prompts you to select an existing LXC container.
  8. +
  9. Checks if the container is privileged and adjusts its settings accordingly.
  10. +
  11. Modifies the container’s configuration to allow GPU access.
  12. +
  13. Installs the required Intel GPU drivers inside the container.
- -

Key Steps

+ +

Step-by-Step Guide

- -

You'll be prompted to select the LXC container you want to enable iGPU acceleration for.

+ +

You will be presented with a list of your LXC containers to choose from.

+ Select LXC Container
- -

The script modifies the container's configuration to allow iGPU access. This includes:

+ +

The script applies the following changes to your container:

    -
  • Ensuring the container is privileged (for necessary permissions)
  • -
  • Enabling nesting feature
  • -
  • Adding device permissions for GPU access
  • -
  • Setting up proper mounts for GPU devices
  • +
  • Switches to privileged mode if required.
  • +
  • Enables the nesting feature.
  • +
  • Grants permissions for GPU access.
  • +
  • Configures necessary device mounts.
+ Modify Container Configuration
- -

Inside the container, the script installs required packages:

+ +

Inside the container, the following GPU-related packages will be installed:

    -
  • GPU drivers (va-driver-all)
  • -
  • OpenCL libraries
  • -
  • Intel GPU tools
  • +
  • va-driver-all - Video acceleration drivers
  • +
  • ocl-icd-libopencl1 - OpenCL runtime
  • +
  • intel-opencl-icd - Intel OpenCL implementation
  • +
  • vainfo - Tool to verify VAAPI support
  • +
  • intel-gpu-tools - Intel GPU debugging tools
-
- -

The script sets up proper permissions for GPU access within the container.

+ Install GPU Drivers
- -

What to Expect

+ +

Expected Outcome

- +

Important Notes

- +

- By using this ProxMenux script, you can easily enable iGPU acceleration in your LXC containers without needing - to manually edit configuration files or run complex commands. + By using ProxMenux, you can enable iGPU acceleration in your LXC containers easily, without manual configuration.

)