Note: this is for installing ZFS on an existing Fedora installation. To use ZFS as root file system, see below.

  1. If zfs-fuse from official Fedora repo is installed, remove it first. It is not maintained and should not be used under any circumstance:

    dnf remove -y zfs-fuse
  2. Add ZFS repo:

    dnf install -y https://zfsonlinux.org/fedora/zfs-release$(rpm -E %dist).noarch.rpm
  3. Install ZFS packages:

    dnf install -y kernel-devel zfs
  4. Load kernel module:

    modprobe zfs

    If kernel module can not be loaded, your kernel version might be not yet supported by OpenZFS. Try install an LTS kernel:

    dnf copr enable -y kwizart/kernel-longterm-5.4
    dnf install -y kernel-longterm kernel-longterm-devel

    Reboot to new LTS kernel, then load kernel module:

    modprobe zfs

    It might be necessary to rebuild module:

    ls -1 /lib/modules \
    | while read kernel_version; do
      dkms autoinstall -k $kernel_version
  5. By default ZFS kernel modules are loaded upon detecting a pool. To always load the modules at boot:

    echo zfs > /etc/modules-load.d/zfs.conf

Testing Repo

Testing repository, which is disabled by default, contains the latest version of OpenZFS which is under active development. These packages should not be used on production systems.

dnf config-manager --enable zfs-testing
dnf install zfs

Root on ZFS

ZFS can be used as root file system for Fedora. An installation guide is available.

Start here.