Home

Welcome to the ArchZFS wiki!

Reporting an issue

To report an issue, please see these instructions.

The package repository

This repository is not endorsed by either Arch Linux or OpenZFS projects. In Arch Linux terms, it is referred to as an “unofficial user repository”.

Included package groups

The ArchZFS repository includes the following package groups that target a particular kernel.

You can install multiple of these groups side by side, but you can't mix “git” and “non-git” versions.

• archzfs-linux

  The default kernel for Arch Linux and latest stable OpenZFS. Use this if you are concerned about ZFS stability.

  WARNING

  While this is the best option for most people, occasionally the OpenZFS project gets behind on stable support for the latest Linux Kernel release. This means that if Linux 4.15 is released to core, but the latest stable release of OpenZFS does not support Linux 4.15, it is not possible to perform a system update. Sometimes it can take a few days, a few weeks, or a month to release a new stable version of OpenZFS. If you happen miss to upgrade a more recent OpenZFS supported version, and the latest stable is ahead of the OpenZFS supported one, there's a solution to upgrade to the latest OpenZFS supported kernel without digging up the matching kernel packages from Arch Linux Archive.

  Some users just wait for a new stable OpenZFS version. It is possible to tell pacman to ignore updates to the linux package in /etc/pacman.conf and keep the system up-to-date, minus the kernel. Other users don't like having a system that is not completely up-to-date. The archzfs project has packages for users of all types!

• archzfs-linux-git

  NOTICE: These packages are currently not provided (summer 2025).

  The for Arch Linux with OpenZFS being built from the latest git commit for ZFS and SPL. Use this if feature is required from OpenZFS that is not included in the latest stable release of OpenZFS, or if the current stable OpenZFS version does not support the Linux version that is in core.

  WARNING

  The packages with "git" in the names in the archzfs repo build from the master branches of the ZFS and SPL repositories of the OpenZFS project. This does result in some risk that a system may become unstable due to unknown bugs. However, every commit that makes it into the master branch in these projects has been regression tested, so there is some comfort in knowing that. In the future, the archzfs project will run the same tests that the OpenZFS project uses after packages are built for reduced risk.

• archzfs-linux-lts and archzfs-linux-lts-git

  NOTICE: The -git packages are currently not provided (summer 2025).

  Support for the lts Linux Kernel packages.

• archzfs-linux-hardened and archzfs-linux-hardened-git

  NOTICE: The -git packages are currently not provided (summer 2025).

  Support for the linux-hardened kernel.

• archzfs-linux-zen and archzfs-linux-zen-git

  NOTICE: The -git packages are currently not provided (summer 2025).

  Support for the linux-zen kernel packages in extra. See https://github.com/zen-kernel/zen-kernel/issues/30 for provide features of the linux-zen kernel.

• archzfs-dkms and archzfs-dkms-git

  NOTICE: The -git packages are currently not provided (summer 2025).

  These packages support all kernels, but need to be automatically rebuilt on every kernel update on the users machine. This can increase the time it takes to update a system. Use this package if switching kernels often.

Using the repository

Without PGP verification

The repository and the packages in it are PGP signed, but the signing system is still being developed and may be subject to change. Until this is finalized, one way to use the repo is with signature validation turned off.

Add the following to /etc/pacman.conf:

[archzfs]
# TODO: Change this to `Required` once it's announced that the signing system is finalized.
SigLevel = Never
Server = https://github.com/archzfs/archzfs/releases/download/experimental

With PGP verification

Add the following to /etc/pacman.conf:

[archzfs]
SigLevel = Required
Server = https://github.com/archzfs/archzfs/releases/download/experimental

Import the current ArchZFS signing key and sign it locally:

# pacman-key --init
# pacman-key --recv-keys 3A9917BF0DED5C13F69AC68FABEC0A1208037BE9
# pacman-key --lsign-key 3A9917BF0DED5C13F69AC68FABEC0A1208037BE9

Mirrors

Since GitHub is reasonably reliable and has extensive CDN on its own, currently no mirrors are provided or planned. If you still would like to host a mirror, please drop a message in the discussions.

Contribute to the project

TBD

Using the test scripts

TBD