.. highlight:: sh

Preparation
======================

.. contents:: Table of Contents
   :local:

#. Disable Secure Boot. ZFS modules can not be loaded if Secure Boot is enabled.
#. Download an older `Arch Linux live image
   <https://geo.mirror.pkgbuild.com/iso/>`__ and boot from it.  Latest
   image may lack a compatible kernel.
#. Connect to the Internet.
#. Set root password or ``/root/.ssh/authorized_keys``.
#. Start SSH server::

    systemctl restart sshd

#. Connect from another computer::

    ssh root@192.168.1.19

#. Use bash shell. Other shells are not tested::

     bash

#. Target disk

   List available disks with::

    find /dev/disk/by-id/

   If using virtio as disk bus, use ``/dev/disk/by-path/``.

   Declare disk array::

    DISK='/dev/disk/by-id/ata-FOO /dev/disk/by-id/nvme-BAR'

   For single disk installation, use::

    DISK='/dev/disk/by-id/disk1'

#. Set partition size:

   Set swap size, set to 1 if you don't want swap to
   take up too much space::

    INST_PARTSIZE_SWAP=4

   Root pool size, use all remaining disk space if not set::

    INST_PARTSIZE_RPOOL=

#. Add ZFS repo::

     curl -L https://archzfs.com/archzfs.gpg |  pacman-key -a -
     pacman-key --lsign-key $(curl -L https://git.io/JsfVS)
     curl -L https://raw.githubusercontent.com/openzfs/openzfs-docs/master/docs/Getting%20Started/Arch%20Linux/archzfs-repo/mirrorlist-archzfs > /etc/pacman.d/mirrorlist-archzfs

     tee -a /etc/pacman.conf <<- 'EOF'

     #[archzfs-testing]
     #Include = /etc/pacman.d/mirrorlist-archzfs

     [archzfs]
     Include = /etc/pacman.d/mirrorlist-archzfs
     EOF

#. Check kernel version::

     uname -r
     #5.18.7-arch1-1

#. Find a ZFS package compatible with the kernel:

   Search kernel version string (e.g. 5.18.7) in both pages:

   * https://archzfs.com/archive_archzfs/
   * https://archzfs.com/archzfs/x86_64/

   Such as::

      curl -L https://archzfs.com/archive_archzfs/ \
      | grep zfs-linux-[0-9] \
      | grep -v src.tar \
      | grep --color "5.18.7"
      # ...<a href="zfs-linux-2.1.5_5.18.7.arch1.1-1-x86_64.pkg.tar.zst">...

   Result: https/.../archive_archzfs/zfs-linux-2.1.5_5.18.7.arch1.1-1-x86_64.pkg.tar.zst

#. Find compatible zfs-utils package:

   Search ZFS version string (e.g. 2.1.5) in both pages above::

      curl -L https://archzfs.com/archzfs/x86_64/ \
      | grep -v src.tar \
      | grep --color zfs-utils-2.1.5
      # ...<a href="zfs-utils-2.1.5-1-x86_64.pkg.tar.zst">...

   Result: https/.../archzfs/x86_64/zfs-utils-2.1.5-2-x86_64.pkg.tar.zst

#. Download both then install::

     pacman -U link-to-zfs.zst link-to-utils.zst

#. Load kernel modules::

    modprobe zfs