/neovim

Installing Neovim

Justin M. Keyes edited this page Nov 18, 2017 · 183 revisions
  • Before upgrading to a new version, always check Following HEAD.
  • To start Neovim, run nvim (not neovim).
  • If you're wondering where to put your config (vimrc) see here.

Install from package

Packages are listed below. (You can also build Neovim from source.)

Windows

chocolatey

  • Release (v0.2): choco install neovim (use -y for automatically skipping confirmation messages)
  • Development (pre-release): choco install neovim --pre

Pre-built archives

  1. Choose a package:
  2. Unzip the package. Any location is fine, administrator privileges are not required.
    • $VIMRUNTIME will be set to that location automatically.
  3. Double-click nvim-qt.exe.

Optional steps:

  • Add the bin folder (e.g. C:\Program Files\nvim\bin) to your PATH.
    • This makes it easy to run nvim and nvim-qt from anywhere.
  • If you are missing VCRUNTIME140.dll, install the Visual Studio 2015 C++ redistributable (choose x86_64 or x86 depending on your system).
  • If :set spell does not work, create the C:/Users/foo/AppData/Local/nvim/site/spell folder. You can then copy your spell files over (for English, located here and here);
  • For Python 2/3 plugins, you need the neovim Python module. "Virtual envs" are recommended. After activating the virtual env, enter pip install neovim (in both). Edit your init.vim so that it contains the path to the env's Python executable: 
    let g:python3_host_prog='C:/Users/foo/Envs/neovim3/Scripts/python.exe'
let g:python_host_prog='C:/Users/foo/Envs/neovim/Scripts/python.exe'
    • Run :CheckHealth and read :help provider-python.
  • init.vim ("vimrc"): If you already have Vim installed you can copy %userprofile%\_vimrc to %userprofile%\AppData\Local\nvim\init.vim to use your Vim config with Neovim.

macOS / OS X

Pre-built archives

The Releases page provides pre-built binaries for macOS 10.8+.

curl -LO https://github.com/neovim/neovim/releases/download/nightly/nvim-macos.tar.gz
tar xzf nvim-macos.tar.gz
./nvim-osx64/bin/nvim

Homebrew (macOS) / Linuxbrew (Linux)

brew install neovim

See the homebrew-neovim README for a complete reference.

Macports 

sudo port selfupdate
sudo port install neovim

Linux

AppImage ("universal" Linux package)

The Releases page provides an AppImage that runs on most Linux systems. No installation is needed, just download nvim.appimage and run it. (It might not work if your Linux distribution is more than 4 years old.)

curl -LO https://github.com/neovim/neovim/releases/download/nightly/nvim.appimage
chmod u+x nvim.appimage
./nvim.appimage

Arch Linux

Neovim can be installed from the community repository:

sudo pacman -S neovim

Alternatively, Neovim can be also installed using the PKGBUILD neovim-git, available on the AUR.

The Python modules are available from the community repository:

sudo pacman -S python2-neovim python-neovim

The Ruby module (currently only supported in neovim-git) is available from the AUR as ruby-neovim.

CentOS 7 / RHEL 7

http://copr.fedoraproject.org/coprs/dperson/neovim/

yum -y install epel-release
curl -o /etc/yum.repos.d/dperson-neovim-epel-7.repo https://copr.fedorainfracloud.org/coprs/dperson/neovim/repo/epel-7/dperson-neovim-epel-7.repo 
yum -y install neovim

It's built using the Copr automated build system, which is unsupported. There's no guarantee of how long the package will be available.

CRUX

A CRUX port is available under 6c37/neovim, along with ports for other dependencies of Neovim.

For instructions on how to install the Python modules, see :help provider-python.

Debian

Neovim is in Debian.

sudo apt-get install neovim

Python (:python) support is also installable via the Debian package manager.

sudo apt-get install python-neovim
sudo apt-get install python3-neovim

Exherbo Linux

Exhereses for scm and released versions are currently available in repository ::medvid. Python client (with GTK+ GUI included) and Qt5 GUI are also available as suggestions:

cave resolve app-editors/neovim --take dev-python/neovim-python --take app-editors/neovim-qt

Fedora

Neovim is in Fedora starting with Fedora 25:

dnf -y install neovim
dnf -y install python2-neovim python3-neovim

Fedora 24 and older

dnf -y copr enable dperson/neovim
dnf -y install neovim
dnf -y install python3-neovim python3-neovim-gui

Gentoo Linux

An ebuild is available in Gentoo's official portage repository:

emerge -a app-editors/neovim

Nix / NixOS

Neovim can be installed with:

nix-env -iA nixpkgs.neovim

To install the Python modules:

nix-env -iA nixpkgs.python35Packages.neovim

Replace python35 with python27 for the python 2 packages.

OpenSUSE

Neovim can be installed with:

sudo zypper in Neovim

To install the Python modules:

sudo zypper in python3-neovim
sudo zypper in python-neovim

PLD Linux

Neovim is in PLD Linux:

poldek -u neovim
poldek -u python-neovim python3-neovim
poldek -u python-neovim-gui python3-neovim-gui

Slackware

See neovim on SlackBuilds.

For instructions on how to install the Python modules, see :help provider-python.

Source Mage

Neovim can be installed using the Sorcery package manager:

cast neovim

Solus

Neovim can be installed using the default package manager in Solus (eopkg):

sudo eopkg install neovim

Ubuntu

Neovim has been added to a "Personal Package Archive" (PPA). This allows you to install it with apt-get. Follow the links to the PPAs to see which versions of Ubuntu are currently available via the PPA. Choose stable or unstable:

To be able to use add-apt-repository you may need to install software-properties-common:

sudo apt-get install software-properties-common

If you're using an older version Ubuntu you must use:

sudo apt-get install python-software-properties

Run the following commands:

sudo add-apt-repository ppa:neovim-ppa/stable
sudo apt-get update
sudo apt-get install neovim

Prerequisites for the Python modules:

sudo apt-get install python-dev python-pip python3-dev python3-pip

If you're using an older version Ubuntu you must use:

sudo apt-get install python-dev python-pip python3-dev
sudo apt-get install python3-setuptools
sudo easy_install3 pip

For instructions to install the Python modules, see :help provider-python.

If you want to use Neovim for some (or all) of the editor alternatives, use the following commands:

sudo update-alternatives --install /usr/bin/vi vi /usr/bin/nvim 60
sudo update-alternatives --config vi
sudo update-alternatives --install /usr/bin/vim vim /usr/bin/nvim 60
sudo update-alternatives --config vim
sudo update-alternatives --install /usr/bin/editor editor /usr/bin/nvim 60
sudo update-alternatives --config editor

Note, however, that special interfaces, like view for nvim -R, are not supported. (See #1646 and #2008.)

Void-Linux

Neovim can be installed using the xbps package manager

sudo xbps-install -S neovim

BSD

FreeBSD

Neovim can be installed using pkg(8):

pkg install neovim

or from the ports tree:

cd /usr/ports/editors/neovim/ && make install clean

Android

Termux on the Google Play store offers a Neovim package.

Install from source

If a package is not provided for your platform, see Building-Neovim. Once you've built Neovim, install it with the following commands:

make
sudo make install

For Unix-like systems this installs Neovim to /usr/local, while for Windows to C:\Program Files. Note, however, that this can complicate uninstallation. The following example avoids this by isolating an installation under $HOME/neovim:

rm -r build/
make CMAKE_EXTRA_FLAGS="-DCMAKE_INSTALL_PREFIX=$HOME/neovim"
make install
export PATH="$HOME/neovim/bin:$PATH"

Note that the rm -r build/ step above is needed if you've built Neovim before, as the install location will be the same as before since CMake caches build information.

Uninstall

To uninstall after make install, just delete the CMAKE_INSTALL_PREFIX artifacts:

sudo rm /usr/local/bin/nvim
sudo rm -r /usr/local/share/nvim/

This is the Neovim wiki. Wiki Home