1
0
mirror of https://github.com/Zygo/bees.git synced 2025-05-17 13:25:45 +02:00
bees/docs/install.md
Zygo Blaxell bcf3e7de3e uuid: drop dependency on uuid.h
The weird things distros do to the path where uuid.h gets installed
have broken bees builds for the last time.

We were only using uuid to support a legacy feature that was removed
over four years ago.

Hypothetical users who are upgrading directly from bees v0.1 should
probably restart all the crawlers anyway--there were bugs.  Also, if any
such users exist, I respect their tremendous patience with the horrible
performance all these years--bees got about 30x faster since v0.1.

Signed-off-by: Zygo Blaxell <bees@furryterror.org>
2021-04-23 08:16:50 -04:00

2.3 KiB

Building bees

Dependencies

  • C++11 compiler (tested with GCC 4.9, 6.3.0, 8.1.0)

    Sorry. I really like closures and shared_ptr, so support for earlier compiler versions is unlikely.

    Note that the C++ standard--and GCC's implementation of it--is evolving. There may be problems when building with newer compiler versions. Build failure reports welcome!

  • btrfs-progs

    Needed at runtime by the service wrapper script.

  • Linux kernel version gets its own page.

  • markdown for documentation

  • util-linux version that provides blkid command for the helper script scripts/beesd to work

Installation

bees can be installed by following one these instructions:

Arch package

bees is available in Arch Linux AUR. Install with:

$ pacaur -S bees-git

Gentoo package

bees is officially available in Gentoo Portage. Just emerge a stable version:

$ emerge --ask bees

or build a live version from git master:

$ emerge --ask =bees-9999

You can opt-out of building the support tools with

USE="-tools" emerge ...

If you want to start hacking on bees and contribute changes, just emerge the live version which automatically pulls in all required development packages.

Build from source

Build with make. The build produces bin/bees which must be copied to somewhere in $PATH on the target system respectively.

It will also generate scripts/beesd@.service for systemd users. This service makes use of a helper script scripts/beesd to boot the service. Both of the latter use the filesystem UUID to mount the root subvolume within a temporary runtime directory.

Ubuntu 16.04 - 17.04:

$ apt -y install build-essential btrfs-tools markdown && make

Ubuntu 18.10:

$ apt -y install build-essential btrfs-progs markdown && make

Ubuntu 14.04:

You can try to carry on the work done here: https://gist.github.com/dagelf/99ee07f5638b346adb8c058ab3d57492

Packaging

See 'Dependencies' below. Package maintainers can pick ideas for building and configuring the source package from the Gentoo ebuild:

https://github.com/gentoo/gentoo/tree/master/sys-fs/bees

You can configure some build options by creating a file localconf and adjust settings for your distribution environment there.

Please also review the Makefile for additional hints.