Skip to main content

Linux

Flatpak​

Flathub:

flatpak install --user io.github.hkdb.Aerion

Note: Flathub releases are usually at least a few hours behind Github releases.

If you want to install the latest Flatpak directly built on Github, you can download the latest .flatpak file from the release page and install it by running the following command in the directory you downloaded it to:

flatpak install --user Aerion-<VERSION>-<ARCH>.flatpak

If Aerion doesn't launch or it behaves weirdly, try the following to disable DMABUF which is known to be buggy for certain hardware combinations:

flatpak run --env=WEBKIT_DISABLE_DMABUF_RENDERER=1 io.github.hkdb.Aerion

If that solves the issues, you can make this permanent with:

flatpak override --user --env=WEBKIT_DISABLE_DMABUF_RENDERER=1 io.github.hkdb.Aerion

Binary + Desktop File + Icon​

If you prefer to use the binary which is most heavily tested:

  1. Aerion requires WebKit2GTK. On a lot of distributions this is already installed, but if it's not, install it on your system:

Debian/Ubuntu:


sudo apt install libwebkit2gtk-4.1-0

Fedora:

sudo dnf install webkit2gtk4.1

Arch Linux:

sudo pacman -S webkit2gtk-4.1
  1. Download the latest tarball for:
  1. Untar and install:
tar -xzvf aerion-linux-*.tar.gz
cd aerion-linux-<arch>
./install.sh
# This install script will give you a choice to install it system-wide or just for the user.
# Follow the prompts and complete the installation.

If you run into any issues running Aerion, try:

export WEBKIT_DISABLE_DMABUF_RENDERER=1 && aerion

If this solves the issues, make this environment variable permanent for the user.

AppImage​

It was impossible to maintain an AppImage for a webkit2gtk-4.1 dependent app that would be compatible with all distros. As such, the AppImage build has been removed from the release/distribution workflow.