There are a few ways to install LunarVim.


No alarm or surprise:

bash <(curl -s


All the new features with all the new bugs:

LV_BRANCH=rolling bash <(curl -s

You can use this helper script to get the latest neovim binary as well:

bash <(curl -s

Make sure to check the troubleshooting section if you encounter any problem.

Tips for WSL 2 users

While using LunarVim within WSL2, there are a few things one should be aware of:

  1. Avoid using LunarVim within the Windows directory, e.g. /mnt/c, due to filesystem performance issues, see WSL#4197open in new window.
  2. Some WSL2 users have experienced that sourcing the clipboard may be slow. A workaround for that is calling a clipboard manager from the Windows side. Neovim tries using win32yank.exeopen in new window if it's available. so install it and set the value of clipboard explicitly:
if vim.fn.has "wsl" == 1 then
  vim.g.clipboard = {
    copy = {
      ["+"] = "win32yank.exe -i --crlf", 
      ["*"] = "win32yank.exe -i --crlf",
    paste = {
      ["+"] = "win32yank.exe -o --lf",
      ["*"] = "win32yank.exe -o --lf",

  1. Some WSL2 users have experienced that opening buffers at startup takes a lot of time. A possible solution is to add the following to your /etc/wsl.conf file:
# Set to true will automount fixed drives (C:/ or D:/) with DrvFs under the root directory set above. Set to false means drives won't be mounted automatically, but need to be mounted manually or with fstab.
enabled = false

# Sets the `/etc/fstab` file to be processed when a WSL distribution is launched.
mountFsTab = false

# Set whether WSL supports interop process like launching Windows apps and adding path variables. Setting these to false will block the launch of Windows processes and block adding $PATH environment variables.
enabled = false
appendWindowsPath = false

Reference: WSL automount settingsopen in new window

Tips for Neovide users

In order to use lunarvim with Neovideopen in new window you need to add the following line to your config.lua

vim.o.guifont = "Your font name"

Where Your Font Name is the literal name of the font you want to use. For example "Inconsolata Nerd Font". You will also need to export the right environment variables and call neovide with the apropriate parameters. An easy way to achieve this is to create a little executable script like, for example ~/.local/bin/lvim-gui

# ~/.local/bin/lvim-gui
export LUNARVIM_RUNTIME_DIR="${LUNARVIM_RUNTIME_DIR:-"$HOME/.local/share/lunarvim"}"

exec neovide -- -u "$LUNARVIM_RUNTIME_DIR/lvim/init.lua" "$@"

Then give it the proper execution permissions

chmod +x ~/.local/bin/lvim-gui

And you can launch from now on like this:

# or with params
lvim-gui some-file


You can remove LunarVim (including the configuration files) using the bundled uninstall script

bash ~/.local/share/lunarvim/lvim/utils/installer/
# or
bash <(curl -s
Last Updated:
Contributors: rebuilt, jamessouth, kylo252, Abouzar Parvan, Ben Berman, Chris, Jan Bronicki, Uzaaft, christianchiarulli, 11backslashes, Binx, Binx-Codes, BrightXiaoHan, Chris, Daniel Rodríguez Rivero, Kid, Miki Vanoušek, R E D O N E, Shivom Srivastava