[Skip to content](#main)

[→](/)

[![Avunu](/brand/avunu-logo.svg)![Avunu](/brand/avunu-logo-light.svg)](/)[Services](/services/)[Consulting](/services/consulting/)[ERP](/services/erp/)[Odoo](/services/erp/odoo/)[ERPNext](/services/erp/erpnext/)[Custom software](/services/custom-software/)[Devices & IoT](/services/devices-iot/)[Websites](/services/websites/)[Infrastructure](/services/infrastructure/)[Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

[About Avunu](/about/)[Team](/about/team/)[Insights](/insights/)[Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

- [Services](/services/)[Consulting](/services/consulting/)
- [ERP](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)
- [Partners](/partners/)

[Work](/work/)[Open source](/open-source/)[Knowledge base](/kb/)[About](/about/)

- [About Avunu](/about/)
- [Team](/about/team/)
- [Insights](/insights/)
- [Contact](/contact/)

[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

[Knowledge base](/kb/)[Linux](/kb/linux/)Intel GPU Kernel Parameters

Search the knowledge basePress/

ESC

Jump to

[Browse the knowledge base](/kb/)[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Linux](/kb/linux/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

↵select↑↓navigateescclose

Search the knowledge base

[Skip to the article](#kb-article)[Linux](/kb/linux/)9 articles

- [Overview](/kb/linux/)
- [Clean Up Stale nginx Unix Sockets with a systemd Drop-in](/kb/linux/nginx-socket-cleanup-drop-in/)
- [Intel GPU Kernel Parameters](/kb/linux/intel-gpu-kernel-parameters/)
- [Media Conversion Recipes](/kb/linux/media-conversion-recipes/)
- [Mount a Drive with a systemd Mount Unit](/kb/linux/systemd-mount-units/)
- [Release Stuck Messages in the Postal Mail Server Queue](/kb/linux/postal-release-queued-messages/)
- [Set Up a WireGuard VPN Host](/kb/linux/wireguard-host-setup/)
- [Shell One-Liners](/kb/linux/shell-one-liners/)
- [Swap Configuration](/kb/linux/swap-configuration/)
- [Switch Commands with update-alternatives and sudo-rs](/kb/linux/sudo-rs-and-update-alternatives/)

Other sections[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

In Linux: 9 articles

[Overview](/kb/linux/)[Clean Up Stale nginx Unix Sockets with a systemd Drop-in](/kb/linux/nginx-socket-cleanup-drop-in/)[Intel GPU Kernel Parameters](/kb/linux/intel-gpu-kernel-parameters/)[Media Conversion Recipes](/kb/linux/media-conversion-recipes/)[Mount a Drive with a systemd Mount Unit](/kb/linux/systemd-mount-units/)[Release Stuck Messages in the Postal Mail Server Queue](/kb/linux/postal-release-queued-messages/)[Set Up a WireGuard VPN Host](/kb/linux/wireguard-host-setup/)[Shell One-Liners](/kb/linux/shell-one-liners/)[Swap Configuration](/kb/linux/swap-configuration/)[Switch Commands with update-alternatives and sudo-rs](/kb/linux/sudo-rs-and-update-alternatives/)

Other sections[Frappe](/kb/frappe/)[ERPNext](/kb/erpnext/)[Odoo](/kb/odoo/)[WordPress](/kb/wordpress/)[NixOS](/kb/nixos/)[Email](/kb/email/)[Databases](/kb/databases/)[Containers](/kb/containers/)[Proxmox](/kb/proxmox/)[Git & Dev Tools](/kb/git-and-dev-tools/)

LinuxIntel GPU Kernel Parameters

What the i915 GuC/HuC and IOMMU kernel parameters do, which Intel GPUs need them, and how to set them for media and passthrough hosts.

UpdatedOct 1, 2026

Applies toLinux 6.xUbuntu 24.04Proxmox VE 8Proxmox VE 9

Tagslinuxkernelintelgpuiommu

Reading time3 min

On this page[Do You Need i915.enable_guc?](#do-you-need-i915enable_guc)[Set the Parameters](#set-the-parameters)[GRUB (Ubuntu, Debian, Proxmox with GRUB)](#grub-ubuntu-debian-proxmox-with-grub)[Proxmox with systemd-boot](#proxmox-with-systemd-boot)[i915 Options Without Touching the Bootloader](#i915-options-without-touching-the-bootloader)[NixOS](#nixos)[Verify](#verify)

These kernel parameters come up on hosts that use an Intel integrated or Arc GPU for hardware video transcoding (Jellyfin, Plex, Frigate) or pass it through to virtual machines. Most are already the default on current kernels, so add only the ones your hardware needs.

| Parameter           | What it does                                                                                                                               |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `i915.enable_guc=3` | Loads the GuC firmware for GPU command submission (bit value 1) and the HuC firmware for media encoding (bit value 2).                     |
| `intel_iommu=on`    | Enables the Intel IOMMU (VT-d), required for PCI passthrough and SR-IOV.                                                                   |
| `iommu=pt`          | Puts devices the host keeps for itself in passthrough mode, avoiding IOMMU translation overhead for them while VFIO devices stay isolated. |

## Do You Need `i915.enable_guc`?

The i915 driver picks the right GuC/HuC mode for each GPU generation automatically (the default is `-1`, auto):

| Platform                                                 | Default        | Notes                                                                                                                  |
| -------------------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Gen9–Gen11 (Skylake through Ice Lake, Comet Lake)        | `0` (off)      | Set `2` to load HuC, which some low-power (VDEnc) encoding paths require. GuC submission isn't supported before Gen11. |
| Tiger Lake, Rocket Lake                                  | `0` (off)      | `3` or `2` enables HuC and, optionally, GuC submission.                                                                |
| Alder Lake-S desktop                                     | `2` (HuC only) |                                                                                                                        |
| Alder Lake-P, Raptor Lake, Meteor Lake, DG2/Arc A-series | `3`            | Already the default. Don't set it.                                                                                     |
| Lunar Lake, Battlemage (Arc B-series) and newer          | n/a            | Driven by the newer `xe` driver, which doesn't use this parameter.                                                     |

Note

`enable_guc` is marked unsafe in the driver, so setting it taints the kernel. That's harmless, but it shows up in bug reports. Install the firmware first: it ships in `linux-firmware` on Ubuntu and Debian (`firmware-misc-nonfree` on plain Debian).

`i915.modeset=1` appears in older guides. It's the default, and the parameter is now deprecated (use `nomodeset` to disable modesetting instead), so leave it out.

## Set the Parameters

Warning

A wrong kernel parameter can leave a machine without a display or unable to boot. Keep console or IPMI access available, and know how to edit the boot entry from the boot menu before you reboot.

### GRUB (Ubuntu, Debian, Proxmox with GRUB)

Edit `/etc/default/grub` and append the parameters to `GRUB_CMDLINE_LINUX_DEFAULT`:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">GRUB_CMDLINE_LINUX_DEFAULT</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">=</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"quiet intel_iommu=on iommu=pt i915.enable_guc=3"</span>
```

Then apply and reboot:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">update-grub</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">reboot</span>
```

### Proxmox with systemd-boot

Proxmox hosts installed on ZFS that boot in UEFI mode without Secure Boot use systemd-boot. Append the parameters to the single line in `/etc/kernel/cmdline`, then run:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">proxmox-boot-tool</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">refresh</span>
```

See [Proxmox Kernel Updates](/kb/proxmox/proxmox-kernel-updates/#change-the-kernel-command-line) for how to tell which bootloader a host uses.

### i915 Options Without Touching the Bootloader

Driver options can also go in a modprobe file, which applies when the module loads:

```
<span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">options i915 </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">enable_guc</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">=3</span>
```

Save it as `/etc/modprobe.d/i915.conf`, then run `update-initramfs -u` and reboot. IOMMU options must stay on the kernel command line.

### NixOS

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">boot</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">.</span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">kernelParams</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA198;--shiki-dark-font-style:italic;--shiki-light:#82071E;--shiki-light-font-style:italic">=</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> [ </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"intel_iommu=on"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"iommu=pt"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">"i915.enable_guc=3"</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> ]</span><span style="--shiki-dark:#FFA198;--shiki-dark-font-style:italic;--shiki-light:#82071E;--shiki-light-font-style:italic">;</span>
```

## Verify

After rebooting, check the command line and the driver's firmware status:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">cat</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">/proc/cmdline</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">dmesg</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">|</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">grep</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-i</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-E</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'guc|huc'</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">dmesg</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">|</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FFA657;--shiki-light:#953800">grep</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-i</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-E</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">'DMAR|IOMMU'</span>
```

Look for lines saying the GuC and HuC firmware loaded and HuC is authenticated, and for `DMAR: IOMMU enabled`. With `intel-gpu-tools` installed, `intel_gpu_top` shows the Video engine busy during a hardware transcode.

Sources

- [docs.kernel.org/gpu/i915.html](https://docs.kernel.org/gpu/i915.html)
- [github.com/torvalds/linux/blob/master/drivers/gpu/drm/i915/gt/uc/intel_uc.c](https://github.com/torvalds/linux/blob/master/drivers/gpu/drm/i915/gt/uc/intel_uc.c)
- [docs.kernel.org/admin-guide/kernel-parameters.html](https://docs.kernel.org/admin-guide/kernel-parameters.html)
- [pve.proxmox.com/wiki/PCI_Passthrough](https://pve.proxmox.com/wiki/PCI_Passthrough)

Need help with Linux servers?

Our notes can take you a long way, but sometimes you'd rather have someone who's done it before.

[Managed infrastructure](/services/infrastructure/)

[← PreviousClean Up Stale nginx Unix Sockets with a systemd Drop-in](/kb/linux/nginx-socket-cleanup-drop-in/)[Next →Media Conversion Recipes](/kb/linux/media-conversion-recipes/)

CC0This article is in the public domain ([CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/)), code samples included. Use it however helps you.

On this page

- [Do You Need i915.enable_guc?](#do-you-need-i915enable_guc)
- [Set the Parameters](#set-the-parameters)
- [GRUB (Ubuntu, Debian, Proxmox with GRUB)](#grub-ubuntu-debian-proxmox-with-grub)
- [Proxmox with systemd-boot](#proxmox-with-systemd-boot)
- [i915 Options Without Touching the Bootloader](#i915-options-without-touching-the-bootloader)
- [NixOS](#nixos)
- [Verify](#verify)

[Back to top↑](#top)

Services

- [ERP implementation](/services/erp/)
- [Odoo](/services/erp/odoo/)
- [ERPNext](/services/erp/erpnext/)
- [Custom software](/services/custom-software/)
- [Devices & IoT](/services/devices-iot/)
- [Websites](/services/websites/)
- [Infrastructure](/services/infrastructure/)

Resources

- [Our work](/work/)
- [Open source](/open-source/)
- [Knowledge base](/kb/)
- [Insights](/insights/)

Company

- [About](/about/)
- [Team](/about/team/)
- [Partners](/partners/)
- [Contact](/contact/)

Clients

- [Project portal](https://erp.avunu.net/projects)
- [Invoices](https://erp.avunu.net/)
- [Support](https://erp.avunu.net/)

[![Avunu](/brand/avunu-logo-light.svg)](/)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M20.400 20.500h-3.600v-5.600c0-1.300 0-3-1.800-3s-2.100 1.400-2.100 2.900v5.700H9.400V9h3.400v1.600c.5-.9 1.600-1.900 3.400-1.900 3.600 0 4.300 2.400 4.300 5.500v6.300zM5.300 7.400a2.100 2.100 0 1 1 0-4.100 2.100 2.100 0 0 1 0 4.100zm1.800 13.100H3.600V9h3.500v11.500zM22.200 0H1.800C.8 0 0 .8 0 1.700v20.600c0 .9.800 1.700 1.800 1.700h20.400c1 0 1.800-.8 1.800-1.700V1.700C24 .8 23.200 0 22.200 0z">\</path>\</svg>\</av-icon>](https://www.linkedin.com/company/avunu)[\<av-icon data-jx-static>\<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor" stroke="none" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false">\<path d="M12 .3a12 12 0 0 0-3.8 23.4c.6.1.8-.3.8-.6v-2c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1-.7.1-.7.1-.7 1.2.1 1.8 1.2 1.8 1.2 1 1.8 2.8 1.3 3.5 1 .1-.8.4-1.3.7-1.6-2.7-.3-5.5-1.3-5.5-5.9 0-1.3.5-2.4 1.2-3.2-.1-.3-.5-1.5.1-3.2 0 0 1-.3 3.3 1.2a11.500 11.500 0 0 1 6 0c2.300-1.500 3.300-1.200 3.300-1.200.6 1.700.2 2.900.1 3.200.8.8 1.200 1.900 1.200 3.200 0 4.600-2.800 5.600-5.500 5.900.4.400.8 1.100.8 2.200v3.300c0 .3.2.7.8.6A12 12 0 0 0 12 .3">\</path>\</svg>\</av-icon>](https://github.com/Avunu)[Client portal](https://erp.avunu.net/projects)[Start a project](/start/)

Avunu LLC · 948 East Philadelphia Street, York, PA 17403 · (717) 814-8540Knowledge base articles are in the public domain[Privacy](/privacy/)[Terms](/terms/)
