Table of contents
ArchZFS
ArchZFS provides ZFS packages for Arch Linux. It is an independent community project and is not endorsed by Arch Linux or OpenZFS.
Important
The supported public repository is hosted in the
archzfs/archzfsGitHub release. The olderarchzfs.comrepository is legacy and should not be used for current package updates.
News
Users configured before 2025-06-19 may need to update the package repository URL.
Packages
The current repository publishes:
zfs-utils, the shared userspace utilities.zfs-dkms, which builds modules locally for installed kernels.zfs-linux,zfs-linux-lts,zfs-linux-hardened, andzfs-linux-zen, prebuilt for exact versions of the corresponding official Arch kernels.- Matching headers and debug packages produced by those package bases.
Git and release-candidate variants remain in the source tree but are not part of the current public release.
Kernel Compatibility
Kernel-specific packages depend on the exact Arch kernel version for which they were built. Arch kernels can advance beyond the range supported by the latest released OpenZFS, temporarily preventing an upgrade of that kernel family. A successful module build is not by itself proof that the combination is inside the support range declared by OpenZFS.
The LTS kernel often remains compatible longer. zfs-dkms is another option,
but it builds modules on the user's system and does not make an unsupported
kernel/OpenZFS combination supported.
Avoid partial upgrades. If a compatible kernel must be retained or restored, follow the ArchWiki's Downgrading packages guidance and keep the kernel, matching headers, and affected kernel modules at compatible versions. Use the Pacman cache or Arch Linux Archive as described there.
Using the Repository
Current repository configuration, signing policy, release-key fingerprint, and
key-import instructions are maintained on the rendered
experimental release page.
Follow that page's current instructions for this channel. Disabling signature
verification is an explicit security tradeoff rather than an equivalent trust
configuration.
The current public Pacman repository is published through the fixed-name
experimental release. Despite the name, it currently packages the released
OpenZFS version selected by ArchZFS and attempts to track current official Arch
kernel packages. OpenZFS updates require a maintainer version and hash update.
If a kernel-module build fails, the release workflow attempts to reuse a
matching signed ArchZFS module package from the failover release. That fallback
is not guaranteed and does not retain or distribute the corresponding official
Arch kernel and headers. Package versions may therefore lag, or a matching
package may be unavailable. Check the release assets before upgrading a
kernel-specific installation.
An installable
archzfs-keyring package is in
development. The release page describes the current manual trust procedure and
the implications of using the repository without verification.
Mirrors
The GitHub release URL above is the authoritative current source. A public mirror is hosted by the Computer-Assisted Research and Teaching Laboratory at the University of Plovdiv, but its replacement synchronization tooling is unfinished and not deployed. The mirror is not currently refreshed automatically and must not be assumed current.
Getting Help and Contributing
- Search and report reproducible package or repository problems in the main issue tracker.
- Use ArchZFS Discussions for broader support questions and proposals.
- Read the organization-wide contribution guide before choosing a repository to change.
The old Packer/QEMU scripts under testing/ are historical, destructive, and
incomplete. The current GitHub Actions checks build packages but do not yet run
a full OpenZFS runtime or data-integrity suite. See the Testing page
for the current boundary.