Files
openzfs-docs/docs/Getting Started/Arch Linux/index.rst
2021-01-25 15:14:23 -06:00

77 lines
1.7 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. highlight:: sh
Arch Linux
============
.. contents:: Table of Contents
:local:
Installation
------------
If you want to use ZFS as your root filesystem, see the `Root on ZFS`_
links below instead.
.. note::
Due to the release cycle of OpenZFS and the rapid adoption of new kernels
it may happen that you wont be able to
build DKMS packages for the most recent kernel update.
If the `latest OpenZFS release <https://github.com/openzfs/zfs/releases/latest>`__
does not yet support the installed kernel,
`downgrade kernel <https://wiki.archlinux.org/index.php/downgrading_packages>`__
before installation.
ZFS packages are provided by the third-party
`archzfs repository <https://github.com/archzfs/archzfs>`__.
You can use it as follows.
Import archzfs GPG key::
curl -O https://archzfs.com/archzfs.gpg
pacman-key -a archzfs.gpg
pacman-key --lsign-key DDF7DB817396A49B2A2723F7403BD972F75D9D76
Add the archzfs repository::
tee -a /etc/pacman.conf <<- 'EOF'
[archzfs]
Server = https://archzfs.com/$repo/$arch
Server = https://mirror.sum7.eu/archlinux/archzfs/$repo/$arch
Server = https://mirror.biocrafting.net/archlinux/archzfs/$repo/$arch
Server = https://mirror.in.themindsmaze.com/archzfs/$repo/$arch
EOF
Update pacman database::
pacman -Sy
Install packages.
* Install prebuilt zfs package.
Kernel package version must match the zfs package version.
- archzfs-linux
- archzfs-linux-lts
- archzfs-linux-zen
- archzfs-linux-hardened
::
pacman -S archzfs-linux
* If kernel dependency fails, or if you use a custom kernel,
install zfs-dkms
::
pacman -S archzfs-dkms
Root on ZFS
-----------
.. toctree::
:maxdepth: 1
:glob:
*Root on ZFS