Files
openzfs-docs/docs/Getting Started/Debian/index.rst
Richard Laager e1f251bba1 Debian: Correct backports pinning
The source package is zfs-linux, not zfsutils-linux.  I had this wrong
in the fix for #314.

Closes #318
Reported-by: Piscium
Signed-off-by: Richard Laager <rlaager@wiktel.com>
2022-06-13 12:40:50 -05:00

63 lines
1.6 KiB
ReStructuredText

.. highlight:: sh
Debian
======
.. contents:: Table of Contents
:local:
Installation
------------
If you want to use ZFS as your root filesystem, see the `Root on ZFS`_
links below instead.
ZFS packages are included in the `contrib repository
<https://packages.debian.org/source/zfs-linux>`__. The
`backports repository <https://backports.debian.org/Instructions/>`__
often provides newer releases of ZFS. You can use it as follows.
Add the backports repository::
vi /etc/apt/sources.list.d/bullseye-backports.list
.. code-block:: sourceslist
deb http://deb.debian.org/debian bullseye-backports main contrib
deb-src http://deb.debian.org/debian bullseye-backports main contrib
::
vi /etc/apt/preferences.d/90_zfs
.. code-block:: control
Package: src:zfs-linux
Pin: release n=bullseye-backports
Pin-Priority: 990
Install the packages::
apt update
apt install dpkg-dev linux-headers-$(uname -r) linux-image-amd64
apt install zfs-dkms zfsutils-linux
**Caution**: If you are in a poorly configured environment (e.g. certain VM or container consoles), when apt attempts to pop up a message on first install, it may fail to notice a real console is unavailable, and instead appear to hang indefinitely. To circumvent this, you can prefix the `apt install` commands with ``DEBIAN_FRONTEND=noninteractive``, like this::
DEBIAN_FRONTEND=noninteractive apt install zfs-dkms zfsutils-linux
Root on ZFS
-----------
.. toctree::
:maxdepth: 1
:glob:
*Root on ZFS
Related topics
--------------
.. toctree::
:maxdepth: 1
Debian GNU Linux initrd documentation