git.sesse.net Git - bcachefs-tools-debian/blob - INSTALL

   1 -- Getting started --
   2
   3 Dependencies:
   4
   5  * libaio
   6  * libblkid
   7  * libkeyutils
   8  * liblz4
   9  * libsodium
  10  * liburcu
  11  * libuuid
  12  * libzstd
  13  * pkg-config
  14  * zlib1g
  15  * valgrind
  16
  17 Debian (Bullseye or later) and Ubuntu (20.04 or later): you can install these with
  18     apt install -y pkg-config libaio-dev libblkid-dev libkeyutils-dev \
  19         liblz4-dev libsodium-dev liburcu-dev libzstd-dev \
  20         uuid-dev zlib1g-dev valgrind libudev-dev git build-essential \
  21         python3 python3-docutils
  22
  23 Fedora: install the "Development tools" group along with:
  24     dnf install -y libaio-devel libsodium-devel \
  25         libblkid-devel libzstd-devel zlib-devel userspace-rcu-devel \
  26         lz4-devel libuuid-devel valgrind-devel keyutils-libs-devel \
  27         findutils
  28
  29 Arch: install bcachefs-tools-git from the AUR.
  30 Or to build from source, install build dependencies with
  31     pacman -S base-devel libaio keyutils libsodium liburcu zstd valgrind
  32
  33 Then, just make && make install
  34
  35
  36 -- Experimental features --
  37
  38 Experimental fuse support is currently disabled by default. Fuse support is at
  39 an early stage and may corrupt your filesystem, so it should only be used for
  40 testing. To enable, you'll also need to add:
  41
  42 * libfuse3 >= 3.7
  43
  44 On Debian/Ubuntu (Bullseye/20.04 or later needed for libfuse >= 3.7):
  45     apt install -y libfuse3-dev
  46
  47 On Fedora (32 or later needed for lbifuse >= 3.7):
  48     dnf install -y fuse3-devel
  49
  50 Arch:
  51     pacman -S fuse3
  52
  53 Then, make using the BCACHEFS_FUSE environment variable (make clean first if
  54 previously built without fuse support):
  55
  56 BCACHEFS_FUSE=1 make && make install
  57
  58
  59 -- Tests --
  60
  61 Some tests are available to validate the "bcachefs" binary.  The tests depend
  62 on python3 pytest.
  63
  64 On debian:
  65     apt install -u python3-pytest
  66
  67 Then, you can run the tests via:
  68
  69     make check
  70     # or if pytest has a different name
  71     make check PYTEST=pytest
  72
  73 Optionally, you may wish to run tests in parallel using python3-pytest-xdist:
  74
  75     cd tests; pytest-3 -n4