diff --git a/web/app/docs/hardware/coral-tpu-lxc/page.tsx b/web/app/docs/hardware/coral-tpu-lxc/page.tsx index 234ebb1..3057f10 100644 --- a/web/app/docs/hardware/coral-tpu-lxc/page.tsx +++ b/web/app/docs/hardware/coral-tpu-lxc/page.tsx @@ -11,21 +11,17 @@ export default function CoralTPULXC() { return (

Enable Coral TPU in an LXC

- +

This guide explains how to configure Google Coral TPU support for LXC containers in Proxmox VE using ProxMenux. Coral TPU provides dedicated AI acceleration, improving inference performance for machine learning applications. It is particularly useful for video surveillance applications with real-time video analysis, such as Frigate or Agent DVR or Blue Iris using CodeProject.AI.

- +

Overview

-

The script automates the following steps:

-
    -
  1. Allows selection of an existing LXC container.
  2. -
  3. Ensures the container is privileged for hardware access.
  4. -
  5. Configures LXC parameters for Coral TPU and Intel iGPU.
  6. -
  7. Installs required drivers and dependencies inside the container.
  8. -
- +

The script automates the complete configuration of Coral TPU support in LXC containers, including USB and M.2 variants. It applies Proxmox-specific container settings, manages device passthrough permissions, and installs required drivers both on the host and inside the container.

+

The USB variant uses a persistent mapping based on /dev/coral via udev rules, avoiding reliance on dynamic USB paths like /dev/bus/usb/*. This ensures consistent device assignment across reboots and hardware reordering.

+

The M.2 version is detected automatically and configured only if present.

+

Implementation Steps

@@ -39,13 +35,47 @@ export default function CoralTPULXC() {
  • Sets device permissions for TPU and iGPU.
  • Configures proper device mounts.
  • + +

    The script installs the necessary components inside the container:

      -
    • GPU drivers (va-driver-all, intel-opencl-icd).
    • -
    • Coral TPU dependencies (Python, GPG keys, repository setup).
    • -
    • Coral TPU drivers (USB and M.2 support).
    • +
    • GPU drivers:
    • +
        +
      • va-driver-all
      • +
      • ocl-icd-libopencl1
      • +
      • intel-opencl-icd
      • +
      • vainfo
      • +
      • intel-gpu-tools
      • +
      +
    • Coral TPU dependencies:
    • +
        +
      • python3
      • +
      • python3-pip
      • +
      • python3-venv
      • +
      • gnupg
      • +
      • curl
      • +
      +
    • Coral TPU drivers:
    • +
        +
      • libedgetpu1-std (standard performance)
      • +
      • libedgetpu1-max (maximum performance, optional)
      • +
    @@ -56,7 +86,7 @@ export default function CoralTPULXC() {
    - +

    Expected Results

    - +

    Important Considerations

    -
    ) }