Skip to main content

INSTALLING

The short version is in the README; this page has the rest.

Works on any distribution, on x86_64 and aarch64 (ARM64). Installing from the signed repo picks the right architecture on its own and keeps the app updated:

flatpak install --user --from https://hylki.hyprlab.co/flatpak/co.hyprlab.Hylki.flatpakref

Prefer a direct download? Each release carries Hylki-x86_64.flatpak and Hylki-aarch64.flatpak; grab the one matching uname -m from the latest release and run flatpak install --user ./Hylki-*.flatpak. The bundle carries the repo address and signing key, so it still receives updates from the official repo. (A bundle holds a single architecture; the repo above holds both.)

Bazaar does not install from a .flatpakref whose repository it does not already know: it reads only the app's ID from the file and reports "ID 'co.hyprlab.Hylki' was not found". Add the repository once, and Hylki then shows up in Bazaar's search:

flatpak remote-add --user --if-not-exists hylki https://hylki.hyprlab.co/flatpak/co.hyprlab.Hylki.flatpakrepo

Fedora​

Add the signed dnf repository on hylki.hyprlab.co and install from it. Hylki then updates with the rest of the system, through GNOME Software or dnf upgrade:

sudo curl -fsSLo /etc/yum.repos.d/hylki.repo https://hylki.hyprlab.co/rpm/hylki.repo
sudo dnf install hylki

dnf asks once to trust the repository's signing key, fingerprint 91A0 AC23 CFD8 C720 4417 B899 8E9F 3DC1 7CFF B221 (the Flatpak repository's key).

The .rpm is also attached to each release. From 1.43.0 the package adds the repository itself, so an RPM installed from a download keeps updating too; it is the same /etc/yum.repos.d/hylki.repo, kept if you edit it (set enabled=0 to stop updates from it).

The RPM targets current Fedora releases (44+) on x86_64 and aarch64. On anything older, use the Flatpak or build from source.

Debian and Ubuntu​

Add the signed apt repository on hylki.hyprlab.co and install from it. Hylki then updates with the rest of the system, through GNOME Software or apt upgrade:

sudo curl -fsSLo /etc/apt/sources.list.d/hylki.sources https://hylki.hyprlab.co/deb/hylki.sources
sudo apt update
sudo apt install hylki

The .sources file carries the repository's signing key, the same key as the dnf repository's, so there is no key to import separately.

The .deb is also attached to each release; install it with sudo apt install ./hylki_*_amd64.deb (_arm64.deb on ARM), which fetches its dependencies. The package adds the repository itself, as the RPM does: the same /etc/apt/sources.list.d/hylki.sources, kept if you edit it (add a line Enabled: no to stop updates from it).

The package needs libadwaita 1.7: Debian 13 (trixie) and later, or Ubuntu 25.10 and later, on x86_64 and arm64. Ubuntu 24.04 LTS and the distributions built on it, such as Linux Mint 22, have an older libadwaita; use the Flatpak there.

AppImage​

One file that runs on any distribution, for x86_64 and aarch64 (ARM64). Download the one matching uname -m, make it executable and run it:

curl -fLO https://hylki.hyprlab.co/download/Hylki-x86_64.AppImage
chmod +x Hylki-x86_64.AppImage
./Hylki-x86_64.AppImage

On ARM, the file is Hylki-aarch64.AppImage. Each release carries both as well.

Each AppImage knows where its updates come from: add it to Gear Lever or AppImageLauncher, or run appimageupdatetool on it, and it updates from hylki.hyprlab.co, fetching only the parts that changed.

The AppImage runs without a sandbox, like the RPM and the Debian package, and shares their settings (~/.config/hylki) and cached mail. OpenPGP uses the system's gpg, which the AppImage does not carry. When the system's fonts hang the message view (#296), it falls back to fonts it carries.

Gentoo​

A community-maintained ebuild lives in bennypowers' overlay (thanks @bennypowers):

eselect repository enable bennypowers
emaint sync -r bennypowers
emerge -av mail-client/hylki

NixOS​

A community-maintained flake lives in clementpoiret's hylki-flake (thanks @clementpoiret). It packages the latest stable release for x86_64 and aarch64. To run it without installing:

nix run github:clementpoiret/hylki-flake

Adding it to a NixOS configuration is covered in its README.

Beta channel​

Betas come in every format the stable release does, on x86_64 and aarch64 (ARM64): Flatpak, RPM and Debian packages, and an AppImage.

The Flatpak beta installs alongside the stable app as a separate application (co.hyprlab.Hylki.Beta) and shares its accounts, settings and cached mail:

flatpak install --user --from https://hylki.hyprlab.co/flatpak/co.hyprlab.Hylki.Beta.flatpakref

Each beta release also carries Hylki-Beta-x86_64.flatpak and Hylki-Beta-aarch64.flatpak for a direct download. To remove the beta, run flatpak uninstall co.hyprlab.Hylki.Beta; the stable app is untouched.

On Fedora, betas also come as RPMs from a beta dnf repository. They replace the installed hylki package rather than sitting beside it, and share its settings. Every RPM from 1.43.0 carries the beta repository, switched off; turn it on once:

sudo dnf config-manager setopt hylki-beta.enabled=1
sudo dnf upgrade --refresh hylki

A beta version such as 1.44.0~beta.1 sorts before 1.44.0, so the stable release replaces the last beta when it comes out, and the next beta follows it. To leave the betas, set hylki-beta.enabled=0; dnf won't move back to an older version by itself, so run sudo dnf distro-sync hylki to return to the newest stable. With an RPM older than 1.43.0, add the beta repository with sudo curl -fsSLo /etc/yum.repos.d/hylki-beta.repo https://hylki.hyprlab.co/rpm/hylki-beta.repo.

On Debian and Ubuntu, betas come from the apt repository's beta suite in the same way. Every Debian package carries it, switched off; turn it on once:

sudo sed -i 's/^Enabled: no/Enabled: yes/' /etc/apt/sources.list.d/hylki-beta.sources
sudo apt update && sudo apt install hylki

To leave the betas, set Enabled: no again, then run sudo apt install hylki/stable to return to the newest stable; apt asks before it moves to an older version.

The beta AppImage is the beta app, "Hylki (beta)" with its own launcher, and updates from the beta channel. Like the packages, it shares the settings and mail of a stable AppImage, RPM or Debian package:

curl -fLO https://hylki.hyprlab.co/download/beta/Hylki-Beta-x86_64.AppImage
chmod +x Hylki-Beta-x86_64.AppImage

On ARM, the file is Hylki-Beta-aarch64.AppImage. To leave the betas, delete it and use the stable AppImage.

Other distributions​

Arch and Snap packages were discontinued after 1.7.0. Use the Flatpak (it works on every distribution) or build from source.

Runtime requirements​

A Secret Service provider (e.g. gnome-keyring, preinstalled on GNOME) is needed for password storage. Address books other than Hylki's own (GNOME Contacts, CardDAV accounts and LDAP directories) are kept by Evolution Data Server, which GNOME installs; on other desktops install the evolution-data-server package. The Flatpak uses the system's, so it is needed there too. Everything else the Flatpak carries; a source, RPM or Debian install also wants gnupg2 (gnupg on Debian) for OpenPGP and nautilus-python (python3-nautilus) for the Files entry.