Linux

System requirements

AssetHoard needs glibc 2.39 or newer. That single requirement is what decides whether your distribution can run it, so the versions below are simply the first release of each distribution to ship a new enough glibc.

We test AssetHoard on Ubuntu, Fedora and Arch. The other distributions should run it happily so long as they ship glibc 2.39 or newer. If yours isn't listed, or you'd rather know before you install, check your glibc version directly.

Checking your glibc version

ldd --version

If that reports anything below 2.39, AssetHoard will install but refuse to start. Several widely used releases fall just short, including Ubuntu 22.04 LTS (2.35), Debian 12 "bookworm" and LMDE 6 (2.36), Fedora 39 (2.38) and openSUSE Leap 15.6 (2.38). You can still run AssetHoard on those systems without upgrading them, which is covered under troubleshooting.

Beyond glibc, AssetHoard needs 4 GB of RAM and about 100 MB of disk space, plus room for your library.

Audio

AssetHoard relies on the GStreamer libraries to be available for sound playback.

Ubuntu

sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav

Fedora

sudo dnf install gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-ugly-free gstreamer1-plugin-libav

On Fedora, the ugly and bad packages have -free variants in the default repos. For full codec support (MP3, AAC, H.264) you'll want RPM Fusion:

sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
sudo dnf install gstreamer1-plugins-bad-freeworld gstreamer1-plugins-ugly

Arch

sudo pacman -S gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad gst-plugins-ugly gst-libav

Troubleshooting

GLIBC version not found

AssetHoard exits immediately on launch with an error like this:

asset-hoard: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.38' not found (required by asset-hoard)

The version named in the error varies by system, so you may see GLIBC_2.39 rather than GLIBC_2.38. Either way the cause is the same: your distribution ships a glibc older than AssetHoard requires. Confirm with ldd --version and compare against system requirements. Upgrading to a supported release fixes it.

Running on an older distribution

If you'd rather not upgrade your whole system, run AssetHoard inside a container that provides a newer glibc. Distrobox suits this well: it runs a different distribution on top of your existing kernel, with your home directory and display already wired up, so AssetHoard behaves like a normal desktop app.

Create an Ubuntu 24.04 container and enter it, then install AssetHoard inside the container exactly as you would on a normal system:

distrobox create --name assethoard --image ubuntu:24.04
distrobox enter assethoard

Installing

Installing from a repository is the option we'd recommend, because AssetHoard then updates alongside the rest of your system. If you'd rather grab a package directly, the downloads page has .deb, .rpm and .pkg.tar.zst builds.

Debian, Ubuntu

Add the signing key and the APT repository, then install:

curl -fsSL https://releases.assethoard.com/apt/assethoard-archive-keyring.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/assethoard-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/assethoard-archive-keyring.gpg] https://releases.assethoard.com/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/assethoard.list

sudo apt update && sudo apt install asset-hoard

Fedora, RHEL, openSUSE

Add the DNF repository, then install:

sudo curl -fsSL https://releases.assethoard.com/rpm/asset-hoard.repo \
  -o /etc/yum.repos.d/asset-hoard.repo

sudo dnf install asset-hoard

Arch (AUR)

Import the release signing key once, so that makepkg can verify the signature:

curl -fsSL https://releases.assethoard.com/apt/assethoard-archive-keyring.gpg \
  | gpg --import

Then install with any AUR helper:

yay -S asset-hoard-bin
# or:
paru -S asset-hoard-bin

Or build it manually, without a helper:

git clone https://aur.archlinux.org/asset-hoard-bin.git
cd asset-hoard-bin && makepkg -si