XIVLauncher for Linux is distributed in many different formats depending on your system setup. Please read below for the recommended way to install XIVLauncher for your system:
- I am using a Steamdeck/Linux handheld with Steam big picture (regardless of if you own FFXIV on Steam): You should follow the install as a compatibility tool guide.
- I am using a desktop Linux distro and own FFXIV through Steam: You should follow the install as a compatibility tool guide.
- I am using a desktop Linux distro and don't own FFXIV through Steam: You should follow the install as a Flatpak or system package guide
- I am using a setup that is not listed here: It may be the case that XIVLauncher may not be officially supported for your setup, but still refer to the install as a Flatpak or system package guide to make sure.
The XIVLauncher Steam compatibility tool is handled by a project called XLM. Automatic install scripts are provided for all major system configurations that will do most of the setup work for you (However if your system configuration is not covered here you can always manually download the XLM binary from the GitHub Releases Page and install that way).
Auto installers for the Steam compatibility tool are provided for the Steam Deck, Flatpak and Native packages of Steam. Simply copy and paste the script for your system into the terminal and the compatibility tool will be installed for you. Afterwards, follow the steps below to start using it. Please note that these scripts CANNOT and SHOULD NOT be ran as sudo or root.
Steamdeck Install Script:
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Blooym/xlm/main/setup/install-steamdeck.sh)"Steam Install Script (Native)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Blooym/xlm/main/setup/install-native.sh)"Steam Install Script (Snap)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Blooym/xlm/main/setup/install-snap.sh)"Steam Install Script (Flatpak)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/Blooym/xlm/main/setup/install-flatpak.sh)"After the installer has finished, please follow these steps to use the compatibility tool:
- Switch back to gaming mode (if on Steam Deck) or restart your Steam client otherwise.
- Navigate to your library and select "FINAL FANTASY XIV Online" or "FINAL FANTASY XIV Online Free Trial" if you are playing via the free trial or don't own the Steam edition of FFXIV.
- Open the game properties menu and switch to the "compatibility" tab.
- Enable the "Force the use of a specific Steam Play compatibility tool" checkbox.
- From the box that appears select "XLCore [XLM]" (if this does not show, please make sure you properly restarted Steam).
- You can now launch the game as usual. XIVLauncher will be automatically installed and run for you.
First, check to see if flathub is installed by running flatpak remotes. If you don't see an entry for flathub, check https://flathub.org/setup for instructions on how to install it.
To install XIVLauncher as a flatpak using the terminal, run the command flatpak install flathub dev.goats.xivlauncher as a regular user ( without sudo).
Some desktop environments provide graphical frontends for Flatpak repositories, allowing you to browse an app store to install Flatpaks in a more intuitive way.
-
If you are using GNOME, open Software and then search for
XIVLauncher. Click on the XIVLauncher entry in the results. ClickInstall. -
If you are using KDE, open Discover and then search for
XIVLauncher. Click on the XIVLauncher entry in the results. ClickInstall.
Other desktop environments may or may not have XIVLauncher available in their own Flatpak frontend applications. If XIVLauncher does not appear in GNOME Software or KDE Discover, verify that Flatpak is installed and running, and verify that you have the Flathub repos enabled.
If you would like to install Final Fantasy XIV to any folder outside of the default (~/.xlcore/ffxiv), you will also need Flatseal from the Discover Store.
Run Flatseal. On the left, scroll down to XIVLauncher. In the main part of the window, scroll down to Filesystem. Click the Folder icon next to Other files. Type the path where you would like to install Final Fantasy XIV.
A list of alternative packages and formats can be found here. Please note that apart from the compatibility tool and the Flatpak, the rest are maintained by members of the community and are deemed unofficial. You will, however, still receieve community support as long as the package is up-to-date.
Configuration files are saved to ~/.xlcore, except when running the compatibility tool with the Steam flatpak wherein the configuration files are saved to ~/.var/app/com.valvesoftware.Steam/.xlcore.
Please make sure that FFXIV or the FFXIV Free Trial from the Steam Store is installed on your Steam Deck's internal memory.
Try adding PULSE_LATENCY_MSEC=60 in your XIVLauncher environment variable settings.
Change the control layout for the game SteamOS thinks FFXIV is running as. For non-Steam service accounts, this means FINAL FANTASY XIV Online Free Trial.
If that does not fix it, rename ~/.xlcore/ffxivConfig/FFXIV.cfg to FFXIV.cfg.bak and run the game again from Gaming Mode. This will reset all Final Fantasy XIV System settings to default. Renaming FFXIV.cfg.bak back to FFXIV.cfg will restore these settings.
Please switch to the compatibility tool version of XIVLauncher and remove the old XIVLauncher flatpak to resolve this problem.
Due to a limitation of Steam's text input API, please use the Steam Deck's Gaming Mode to finish setup.
This means that XIVLauncher was unable to find a secure way to store your passwords. This is usually because you don't have a secrets manager like GNOME Keyring or KDE Wallet installed on your system. It's recommended you install a recognised and well known secrets manager to solve this problem.
If you are using a Steamdeck or are unable to install a secrets manager, you can run XIVLauncher with XL_SECRET_PROVIDER=file to store your credentials insecurely via a file. This will be done for you if you are using the compatibility tool on Steamdeck or with Flatpak Steam.