Installing League of Legends via leagueoflegends-git
What is leagueoflegends-git?
leagueoflegends-git is a helper script for installing and running League of Legends on Linux maintained by /u/kyechou found on Github.
Please choose an installation method suitable for your distribution. Remember to check all dependencies are installed properly if it's installed manually.
sudo dpkg -i <deb_file>
sudo make install
With package installation methods, packages specific to individual GPUs are not included in the dependencies, even though we do include the virtual packages
lib32-vulkan-driverin the AUR package. So please be sure to install the packages required by your specific GPUs. For example, Debian testing requires libnvidia-glvkspirv and libglx-nvidia0 for Nvidia GPUs (see #41).
The following dependencies are included in the AUR package and the generated
.deb package. If there's anything incorrect or missing, pull requests are
For non-Arch distributions, wine-lol is not included in the package dependencies because they don't have those packages for now. So please be sure to manually install wine-lol by either downloading from a release of wine-ge-custom (which is the same as wine-lol-bin), or from a release of lol-for-linux-installer. After downloading the binary release, extract the content to
- wine-lol (please refer to the associated links for their differences)
- Provider: wine-lol (AUR)
- Provider: wine-lol-bin (AUR)
- Provider: wine-lol-staging (AUR)
- Provider: wine-lol-staging (pre-built)
- gnutls, lib32-gnutls
- libldap, lib32-libldap
- openal, lib32-openal
- libpulse, lib32-libpulse
- alsa-lib, lib32-alsa-lib
- mpg123, lib32-mpg123
- unixodbc, lib32-unixodbc
- vkd3d, lib32-vkd3d
- vulkan-icd-loader, lib32-vulkan-icd-loader
- Vulkan drivers for your graphic
cards, both 64-bit and 32-bit packages are required at the moment until Riot
ships only the 64-bit binaries. For example:
- vulkan-intel, lib32-vulkan-intel
- nvidia-utils, lib32-nvidia-utils
- vulkan-radeon, lib32-vulkan-radeon
- amdvlk, lib32-amdvlk
The above package names are based on Arch Linux. For other distributions, the package names will be different. Please refer to the documentation of the distribution for installing the correct Vulkan drivers and other dependencies.
There is no need for configuration. You may feel free to skip this part, unless you want to change the install path of the game or where the cache is placed.
The helper script looks for configuration files located at
~/.config/league.sh, in that order. The
configuration file is a shell script and will be sourced before starting the
game. You may define any environment variables or run any commands you want,
which might be helpful in special situations.
These are the variables that will be explicitly referenced and used:
DATA_HOME: The path where the game is, or will be, installed. (Default:
CACHE_HOME: The path for the cache files. (Default:
For example, if the configuration file doesn't exist or if the
variable is not defined, the game would then be installed at
~/.local/share/leagueoflegends/ by default.
Pre-client-installation checks (Important!)
- Please make sure you have installed the correct Vulkan driver for your graphics card that you will be using. You can check what is installed with
Install the Riot and League client
- First install the game:
- Please do not log in or launch the game during installation.
- If the installation progress stucks at 100%, close the window, and run
- For more detail, check out this thread.
- Exit the window when the game installation is finished. (The progress circle disappears.)
- Start the game:
- Log in with your Riot credentials and start LoL as usual.
- Once the League client shows up, please try a practice match to make sure everything works.
- To remove the game:
If you've run wine-lol-staging or other flavors of wine 8.0+ before and now have issues with launching the client (especially if you're coming from version 8 to 7), and it says something about
unimplemented function winegstreamer.dll.winegstreamer_create_video_decoder. It's because of the difference in wine versions. You need to recreate the wine prefix for it to work, by running
If you use Nvidia graphics card and have trouble launching the League client or start the game (after champion selection), please check out the troubleshooting section.
leagueoflegends -h can be used to view the full list of options and commands.
[!] Usage: leagueoflegends [options] <command>
League of Legends - helper program
-h, --help Print this message and exit
-v, --verbose Enable verbose output
--pbe Launch the PBE patchline
--locale <locale> Set locale (if different from the region)
start Start LoL
stop Same as kill
install Install LoL
uninstall Uninstall LoL
reinstall Reinstall LoL
reset-wineprefix Reset wine prefix
replay <path> Replay match (.rofl file)
add-dxvk Install DXVK to the LoL wineprefix
del-dxvk Remove DXVK from the LoL wineprefix
rm-dxvk-cache Remove DXVK cache
cleanup-logs Remove log files
kill Kill the wine processes of the wineprefix
run <cmd> Run shell command with environment variables
Optimal performance settings
You may need to adjust some settings for optimal performance once installed. Read more in 📈 How to Optimise League of Legends.
Something not working?
Read more on common problems, how to solve them, and other troubleshooting tips in 🛠️ Troubleshooting and Technical Support.