[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/)[Proxmox](/kb/proxmox/)Install, Pin, and Configure Proxmox VE Kernels

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)[Proxmox](/kb/proxmox/)1 article

- [Overview](/kb/proxmox/)
- [Install, Pin, and Configure Proxmox VE Kernels](/kb/proxmox/proxmox-kernel-updates/)

Other sections[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/)[Git & Dev Tools](/kb/git-and-dev-tools/)

In Proxmox: 1 article

[Overview](/kb/proxmox/)[Install, Pin, and Configure Proxmox VE Kernels](/kb/proxmox/proxmox-kernel-updates/)

Other sections[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/)[Git & Dev Tools](/kb/git-and-dev-tools/)

ProxmoxInstall, Pin, and Configure Proxmox VE Kernels

Install an opt-in Proxmox kernel, pin or unpin a kernel version, and change the kernel command line on GRUB or systemd-boot hosts.

UpdatedOct 1, 2026

Applies toProxmox VE 8Proxmox VE 9

Tagsproxmoxkernelsystemd-bootgrub

Reading time4 min

On this page[Check the Running Kernel and Installed Kernels](#check-the-running-kernel-and-installed-kernels)[Install an Opt-in Kernel](#install-an-opt-in-kernel)[Pin a Kernel Version](#pin-a-kernel-version)[Change the Kernel Command Line](#change-the-kernel-command-line)[systemd-boot](#systemd-boot)[GRUB](#grub)[Disabling CPU Vulnerability Mitigations](#disabling-cpu-vulnerability-mitigations)

Proxmox VE ships its own kernel packages, which include ZFS and are tested with the rest of the platform. When you need newer hardware support, you can install one of the newer opt-in kernels, pin the host to a known-good version, and adjust kernel parameters. Run the commands as root on the node.

Note

Older notes installed Debian backports kernels (`linux-image-amd64` with `zfs-dkms`) on Proxmox. Don't do that on current releases. Proxmox's opt-in kernels give you the same newer hardware support with ZFS built in and without DKMS rebuilds.

## Check the Running Kernel and Installed Kernels

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">uname</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-r</span>
<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">kernel</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">list</span>
```

## Install an Opt-in Kernel

Proxmox publishes newer kernels as opt-in packages, announced on the Proxmox forum. For example, `proxmox-kernel-7.0` on Proxmox VE 9 or `proxmox-kernel-6.14` on Proxmox VE 8:

```
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">apt</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">update</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">apt</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">install</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">proxmox-kernel-</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">VERSIO</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">N</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">reboot</span>
```

Once installed, later builds of that kernel series arrive with normal updates. Opt-in kernels are less tested than the default series, so try them on one node first.

## Pin a Kernel Version

By default, the node boots the newest installed kernel. To boot a specific version instead, for example to stay on a kernel that works with a particular NIC or GPU driver, pin it. Use the exact version string from `proxmox-boot-tool kernel list`:

```
<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">kernel</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">pin</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">KERNEL_VERSIO</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">N</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span>
```

To try a kernel for a single boot only, so a failed boot falls back on the next reboot:

```
<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">kernel</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">pin</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E"><</span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">KERNEL_VERSIO</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328">N</span><span style="--shiki-dark:#FF7B72;--shiki-light:#CF222E">></span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">--next-boot</span>
```

Remove the pin to go back to booting the newest kernel:

```
<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">kernel</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#A5D6FF;--shiki-light:#0A3069">unpin</span>
```

Pinning works with both GRUB and systemd-boot.

## Change the Kernel Command Line

Where kernel parameters go depends on the bootloader. Find out which one the host uses:

```
<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">status</span>
<span style="--shiki-dark:#FFA657;--shiki-light:#953800">efibootmgr</span><span style="--shiki-dark:#E6EDF3;--shiki-light:#1F2328"> </span><span style="--shiki-dark:#79C0FF;--shiki-light:#0550AE">-v</span>
```

`efibootmgr` shows `systemd-bootx64.efi` for systemd-boot, and `grubx64.efi` or `shimx64.efi` for GRUB. On a legacy BIOS host, it reports that EFI variables aren't supported, which means GRUB. In practice, ZFS-on-root installs booting in UEFI mode without Secure Boot use systemd-boot, and everything else uses GRUB.

### systemd-boot

Edit `/etc/kernel/cmdline`. It's a single line, so append parameters to the end:

```text
root=ZFS=rpool/ROOT/pve-1 boot=zfs intel_iommu=on iommu=pt
```

Then copy the change to every boot partition:

```
<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>
```

### GRUB

Edit `GRUB_CMDLINE_LINUX_DEFAULT` in `/etc/default/grub`:

```
<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"</span>
```

Then regenerate the GRUB config:

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

After rebooting, confirm the parameters took effect with `cat /proc/cmdline`.

Warning

Kernel and command-line changes can leave a node unbootable. Keep console or IPMI access available, migrate or shut down guests first, and on a cluster change one node at a time.

## Disabling CPU Vulnerability Mitigations

Some performance guides suggest adding `mitigations=off` to the kernel command line. It turns off the kernel's protections against Spectre, Meltdown, and related CPU flaws, which can win back a few percent of CPU performance on older processors.

Warning

On a hypervisor, `mitigations=off` lets code in one VM potentially read memory from the host or from other VMs. Never use it on hosts that run untrusted guests, customer workloads, or anything exposed to the internet. Measure the actual gain before considering it on an isolated lab host.

Sources

- [pve.proxmox.com/wiki/Host_Bootloader](https://pve.proxmox.com/wiki/Host_Bootloader)
- [pve.proxmox.com/pve-docs/chapter-sysadmin.html#sysboot](https://pve.proxmox.com/pve-docs/chapter-sysadmin.html#sysboot)
- [forum.proxmox.com/threads/opt-in-linux-7-0-kernel-for-proxmox-ve-9-available.182328](https://forum.proxmox.com/threads/opt-in-linux-7-0-kernel-for-proxmox-ve-9-available.182328/)

Need help with Proxmox?

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

[Managed infrastructure](/services/infrastructure/)

[← PreviousOverview](/kb/proxmox/)

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

- [Check the Running Kernel and Installed Kernels](#check-the-running-kernel-and-installed-kernels)
- [Install an Opt-in Kernel](#install-an-opt-in-kernel)
- [Pin a Kernel Version](#pin-a-kernel-version)
- [Change the Kernel Command Line](#change-the-kernel-command-line)
- [systemd-boot](#systemd-boot)
- [GRUB](#grub)
- [Disabling CPU Vulnerability Mitigations](#disabling-cpu-vulnerability-mitigations)

[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/)
