+2
Daily
+16
Weekly
+42
Monthly
14,014
stars
2,502
forks
78
watchers
2,972
prs
1,488
issues
24
releases
README
nvim-lspconfig
nvim-lspconfig is a collection of LSP server configurations for the Nvim LSP client.
View all configs, or run :help lspconfig-all from Nvim.
Important ⚠️
require('lspconfig') (the legacy "framework" of nvim-lspconfig) is deprecated in favor of vim.lsp.config (Nvim 0.11+).
The lspconfig.lua module will be dropped. Calls to require('lspconfig') will show a warning, which will later become an error.
nvim-lspconfig itself is NOT deprecated. It provides server-specific configs.
The configs live in the lsp/ directory. vim.lsp.config automatically finds them and merges them with any local lsp/.lua configs defined by you or a plugin.
The old configs in lua/lspconfig/ are deprecated and will be removed.
Migration instructions
1. Upgrade to Nvim 0.11+
2. (Optional) Use vim.lsp.config('…') (not require'lspconfig'.….setup{}) to customize or define a config.
3. Use vim.lsp.enable('…') (not require'lspconfig'.….setup{}) to enable a config, so that it activates for its filetypes.
Support
These configs are best-effort and supported by the community (you). See contributions.
Ask questions on GitHub Discussions, not the issue tracker.
If you found a bug in Nvim LSP (:help lsp), report it to Neovim core.
Do not report it here. Only configuration data lives here.
Install
Requires Nvim 0.11.3+.
Support for Nvim 0.10 will be removed. Upgrade Nvim and nvim-lspconfig before reporting an issue.
With Nvim 0.12+, you can use the builtin vim.pack plugin manager:
lua
vim.pack.add{
{ src = 'https://github.com/neovim/nvim-lspconfig' },
}
Or install nvim-lspconfig using Vim's "packages" feature:
git clone https://github.com/neovim/nvim-lspconfig ~/.config/nvim/pack/nvim/start/nvim-lspconfig
Or use a 3rd-party plugin manager.
Quickstart
1. Install a language server, e.g. pyright
bash
npm i -g pyright
2. Enable its config in your init.lua (:help lsp-quickstart).
lua
vim.lsp.enable('pyright')
3. Ensure your project/workspace contains a root marker as specified in :help lspconfig-all.
4. Open a code file in Nvim. LSP will attach and provide diagnostics.
nvim main.py
5. Run :checkhealth vim.lsp to see the status or to troubleshoot.
See :help lspconfig-all for the full list of server-specific details. For
servers not on your $PATH (e.g., jdtls, elixirls), you must manually set
the cmd parameter:
lua
vim.lsp.config('jdtls', {
cmd = { '/path/to/jdtls' },
})
Commands
:LspInfo (alias to :checkhealth vim.lsp) shows the status of active and configured language servers.
:lsp enable [] (:LspStart for Nvim 0.11 or older) Start the requested server name. Will only successfully start if the command detects a root directory matching the current config.
:lsp disable [] (:LspStop for Nvim 0.11 or older) Stops the given server. Defaults to stopping all servers active on the current buffer. To force stop use :LspStop!
:lsp restart [] (:LspRestart for Nvim 0.11 or older)Top issues
#3003Workspaces not added to the server again when initially removed16 comments · 2024-02-09#3705Missing legacy configs15 comments · 2025-04-11#3376can :LspInfo (:checkhealth vim.lsp) show more detailed info?14 comments · 2024-10-16#3818.oxlintrc.json not found (because insert_package_json() searchs breadth-first instead of depth-first)13 comments · 2025-05-03#3728[blocked] remove .git from root_markers10 comments · 2025-04-15#4286Base config isn't importable by plugin user5 comments · 2026-01-19#3894julia formatter ignores config file one folder out5 comments · 2025-06-08#3889`:LspRestart eslint` results in 'Unable to find ESLint library' when using Yarn PnP (using lua/lspconfig/ with Nvim 0.11.2)5 comments · 2025-06-05
Latest release
v2.12.0 v2.12.0 2026-09-23What's Changed feat: agentscript by @Booyaka101 in https://github.com/neovim/nvim-lspconfig/pull/4483 docs(astro): update language-tools URLs by @tdhuan in https://github.com/neovim/nvim-lspconfig/pull/4485 docs(astro): document TypeScript 7.x limitation and npm-global fallback example by @tdhuan in https://github.com/neovim/nvim-lspconfig/pull/4486 corrected roslyn_ls.lua call to .iter to take a table as expected by @chepeniv in https://github.com/neovim/nvim-lspconfig/pull/4487 feat(oxfmt): enable for svelte by @igorlfs in https://github.com/neovim/nvim-lspconfig/pull/4488 docs(e