Installation Linux

RiftLauncher publishes three Linux build types: AppImage, DEB and Flatpak. AppImage works on any distro and is the one with automatic updates; DEB and Flatpak have no automatic updates, so you'll need to grab a new file yourself for each release.

Note: the Flatpak build isn't packaged with .NET, so on an immutable distro Vintage Story itself may not work through it yet.

AppImage (recommended)

1. Go to the GitHub Releases page and download the .AppImage file from the latest release's Assets list.

2. Move it somewhere you won't accidentally delete it, for example your Desktop or ~/Applications.

3. Make it executable:

   chmod +x ./riftlauncher-X.X.X.AppImage

4. Double-click it to open RiftLauncher.

Note: some users have reported that AppImageLauncher interferes with RiftLauncher's automatic updates. If you use it, make sure you're on the latest version when you install.

DEB or Flatpak

Install either with a double-click, or from a terminal:

sudo dpkg -i riftlauncher-X.X.X.deb
# or
flatpak install riftlauncher-X.X.X.flatpak

Then just open RiftLauncher like any other app. Since neither of these builds auto-updates, check the Releases page for new versions yourself.

Moving your config between build types

AppImage and DEB builds store their config under ~/.config; Flatpak builds store it in Flatpak's own per-app data directory under ~/.var/app/. If you switch build types and want to keep your installations, versions and settings, copy your config.json from the old location into the new one, then restart RiftLauncher.

Installing Vintage Story's own dependencies

RiftLauncher itself needs no extra dependencies, but Vintage Story does, and this isn't automated since Linux distros vary too much to cover them all from inside the launcher. Pick your distro below.

Debian, Ubuntu and derivatives

wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh
chmod +x ./dotnet-install.sh
sudo ./dotnet-install.sh --channel 7.0 --install-dir /usr/lib/dotnet
sudo ./dotnet-install.sh --channel 8.0 --install-dir /usr/lib/dotnet
sudo ./dotnet-install.sh --channel 10.0 --install-dir /usr/lib/dotnet
sudo apt install libopenal-dev mono-complete
sudo sysctl -w vm.max_map_count=262144

You'll also need your graphics driver installed; how to do that depends on your card and distro.

Arch and derivatives

sudo pacman -S dotnet-runtime-7.0 dotnet-runtime-8.0 dotnet-runtime glibc openal opengl-driver mono

Again, install your graphics driver separately first.

SteamOS

sudo steamos-readonly disable
sudo pacman-key --init
sudo pacman-key --populate archlinux
sudo pacman-key --populate holo
sudo pacman -S dotnet-runtime-7.0 dotnet-runtime-8.0 dotnet-runtime glibc openal opengl-driver mono
sudo steamos-readonly enable

This sequence was contributed by a SteamOS user; it hasn't been independently verified step by step.

NixOS

AppImages need a couple of options enabled, since they can't see system libraries like .NET by default:

programs.appimage.enable = true;
programs.appimage.binfmt = true;
programs.appimage.package = pkgs.appimage-run.override { extraPkgs = pkgs: [
  pkgs.dotnet-runtime
]; };

This enables AppImage support system-wide, and every AppImage on the system gets .NET available to it, not just RiftLauncher's.

Something not working?

Report it on the issue tracker, or ask on the Stratum Discord server or the official Vintage Story Discord.