Files
openzfs-docs/docs/Getting Started/Debian/index.rst
George Melikov 1d2ffe3528 Apt: use kernel/headers meta packages
- `generic` packages exist since bullseye
- older versions have `amd64` meta package
2022-07-13 23:41:59 +03: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-generic linux-image-generic
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