Unverified Commit 8476b027 authored by Maximilian Bosch's avatar Maximilian Bosch
Browse files

nixos/doc: suggest using the latest longterm kernel for ZFS

parent fa257ecb

nixos/doc/manual/configuration/linux-kernel.chapter.md

+4 −1
Original line number Diff line number Diff line
@@ -152,7 +152,10 @@ $ make -C $dev/lib/modules/*/build M=$(pwd)/drivers/net/ethernet/mellanox module 
## ZFS {#sec-linux-zfs}



It's a common issue that the latest stable version of ZFS doesn't support the latest

available Linux kernel. It's possible to pin the system to the latest available kernel

available Linux kernel. It is recommended to use the latest available LTS that's compatible

with ZFS. Usually this is the default kernel provided by nixpkgs (i.e. `pkgs.linuxPackages`).



Alternatively, it's possible to pin the system to the latest available kernel

version *that is supported by ZFS* like this:



```nix

nixos/doc/manual/from_md/configuration/linux-kernel.chapter.xml

+9 −3
Original line number Diff line number Diff line
@@ -171,9 +171,15 @@ $ make -C $dev/lib/modules/*/build M=$(pwd)/drivers/net/ethernet/mellanox module 
    <title>ZFS</title>

    <para>

      It’s a common issue that the latest stable version of ZFS doesn’t

      support the latest available Linux kernel. It’s possible to pin

      the system to the latest available kernel version <emphasis>that

      is supported by ZFS</emphasis> like this:

      support the latest available Linux kernel. It is recommended to

      use the latest available LTS that’s compatible with ZFS. Usually

      this is the default kernel provided by nixpkgs (i.e.

      <literal>pkgs.linuxPackages</literal>).

    </para>

    <para>

      Alternatively, it’s possible to pin the system to the latest

      available kernel version <emphasis>that is supported by

      ZFS</emphasis> like this:

    </para>

    <programlisting language="bash">

{