yuri-potatoq/hytale-linux-native-installation.md

Hytale Launcher — Linux Native Install Guide

Covers Arch / Manjaro, Ubuntu / Debian / Mint, and Fedora.
No Flatpak. Just the native binary from Hytale's servers.

1. Download & Extract

wget https://launcher.hytale.com/builds/release/linux/amd64/hytale-launcher-latest.zip
unzip hytale-launcher-latest.zip -d hytale-launcher
cd hytale-launcher
chmod +x hytale-launcher

2. Check What Is Already Missing (optional but recommended)

ldd ./hytale-launcher | grep "not found"

Any library listed as not found needs to be installed. Use this to catch distro-specific gaps not covered below.

3. Base Packages

Install these regardless of your GPU or desktop environment.

Arch / Manjaro

sudo pacman -S \
  glib2 gtk3 webkit2gtk-4.1 glib-networking \
  gsettings-desktop-schemas \
  libdrm libxkbcommon \
  libx11 libxcomposite libxdamage libxext libxfixes libxrandr libxshmfence \
  pango cairo freetype2 fontconfig \
  alsa-lib libpulse pipewire-pulse \
  nss nspr openssl \
  atk at-spi2-atk libcups expat dbus \
  gcc-libs xdg-utils hicolor-icon-theme

Ubuntu 24.04+ / Debian 12+ / Mint 22+

sudo apt install \
  libglib2.0-0 libgtk-3-0 libwebkit2gtk-4.1-0 glib-networking \
  gsettings-desktop-schemas \
  libdrm2 libxkbcommon0 \
  libx11-6 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 libxshmfence1 \
  libpango-1.0-0 libcairo2 libfreetype6 libfontconfig1 \
  libasound2t64 libpulse0 \
  libnss3 libnspr4 libssl3 \
  libatk1.0-0 libatk-bridge2.0-0 libcups2 libexpat1 libdbus-1-3 \
  libstdc++6 xdg-utils hicolor-icon-theme

Ubuntu 22.04 / Mint 21: replace libwebkit2gtk-4.1-0 with libwebkit2gtk-4.0-0 and libasound2t64 with libasound2.

Fedora 40+

sudo dnf install \
  glib2 gtk3 webkit2gtk4.1 glib-networking \
  gsettings-desktop-schemas \
  libdrm libxkbcommon \
  libX11 libXcomposite libXdamage libXext libXfixes libXrandr libxshmfence \
  pango cairo freetype fontconfig \
  alsa-lib pulseaudio-libs pipewire-pulseaudio \
  nss nspr openssl-libs \
  atk at-spi2-atk cups-libs expat dbus-libs \
  libstdc++ xdg-utils hicolor-icon-theme

4. GPU Drivers

Install the section matching your graphics card in addition to the base packages.

NVIDIA

Distro	Command
Arch	`sudo pacman -S nvidia-utils libglvnd vulkan-icd-loader`
Ubuntu/Mint	`sudo apt install nvidia-driver-570 libvulkan1 libgl1` (adjust driver version)
Fedora	`sudo dnf install akmod-nvidia vulkan-loader` then reboot

On Ubuntu/Mint, if you installed NVIDIA via the GUI driver manager, libvulkan1 is usually the only missing piece.

AMD (RDNA / GCN)

Distro	Command
Arch	`sudo pacman -S mesa vulkan-radeon libva-mesa-driver mesa-vdpau`
Ubuntu/Mint	`sudo apt install mesa-vulkan-drivers libvulkan1 libgl1-mesa-dri`
Fedora	`sudo dnf install mesa-vulkan-drivers mesa-dri-drivers vulkan-loader`

Intel (Iris / Arc)

Distro	Command
Arch	`sudo pacman -S mesa vulkan-intel intel-media-driver`
Ubuntu/Mint	`sudo apt install mesa-vulkan-drivers libvulkan1 intel-media-va-driver libgl1-mesa-dri`
Fedora	`sudo dnf install mesa-vulkan-drivers intel-media-driver vulkan-loader`

5. Desktop Environment

These packages ensure xdg-open can launch your browser for login, and that keyring/portal services work correctly.

GNOME

Most dependencies ship with a default GNOME install. You may just need:

Distro	Command
Arch	`sudo pacman -S xdg-desktop-portal xdg-desktop-portal-gnome gnome-keyring`
Ubuntu/Mint	`sudo apt install xdg-desktop-portal xdg-desktop-portal-gnome gnome-keyring`
Fedora	`sudo dnf install xdg-desktop-portal xdg-desktop-portal-gnome gnome-keyring`

KDE Plasma

The launcher is GTK-based, so a few GTK bridge packages are needed:

Distro	Command
Arch	`sudo pacman -S xdg-desktop-portal xdg-desktop-portal-kde gtk3 libsecret`
Ubuntu/Mint	`sudo apt install xdg-desktop-portal xdg-desktop-portal-kde libsecret-1-0`
Fedora	`sudo dnf install xdg-desktop-portal xdg-desktop-portal-kde libsecret`

KDE uses KWallet for credentials. Make sure KWallet is unlocked before launching.

XFCE

XFCE is minimal and usually missing several GTK services that the launcher expects:

Distro	Command
Arch	`sudo pacman -S xdg-desktop-portal xdg-desktop-portal-gtk gnome-keyring libsecret dconf`
Ubuntu/Mint	`sudo apt install xdg-desktop-portal xdg-desktop-portal-gtk gnome-keyring libsecret-1-0 dconf-cli`
Fedora	`sudo dnf install xdg-desktop-portal xdg-desktop-portal-gtk gnome-keyring libsecret dconf`

On XFCE you may also need to start gnome-keyring-daemon manually if login doesn't open a browser:
eval $(gnome-keyring-daemon --start)
export GNOME_KEYRING_CONTROL

6. Run

cd hytale-launcher
./hytale-launcher

To install it system-wide:

sudo mkdir -p /opt/hytale-launcher
sudo cp -r . /opt/hytale-launcher/
sudo ln -s /opt/hytale-launcher/hytale-launcher /usr/local/bin/hytale-launcher

Troubleshooting

Symptom	Likely cause	Fix
`Unable to open default system browser`	`xdg-open` can't reach D-Bus	Install `xdg-desktop-portal` + your DE backend (section 5)
Black / blank launcher window	Missing WebKit	Check `webkit2gtk` version matches your distro
Launcher crashes on start	Missing Vulkan ICD	Install GPU Vulkan package (section 4), run `vulkaninfo` to verify
No audio in-game	Wrong audio backend	Install both `alsa-lib` and `libpulse`; ensure PipeWire is running
`libssl.so.3: not found`	Old OpenSSL	On Ubuntu 22.04, install `libssl3` from backports