mason-org /mason.nvim
Portable package manager for Neovim that runs everywhere Neovim runs. Easily install and manage LSP servers, DAP servers, linters, and formatters.
★ 10,539⑂ 345👁 26⑃ 992● 743▤ 30
+3
Daily
+16
Weekly
+32
Monthly
10,539
stars
345
forks
26
watchers
992
prs
743
issues
30
releases
README
!Linux
!macOS
!Windows
Portable package manager for Neovim that runs everywhere Neovim runs.
Easily install and manage LSP servers, DAP servers, linters, and formatters.
:help mason.nvim
Latest version: v2.3.1
Table of Contents
- Introduction
- Installation & Usage
- Recommended setup for lazy.nvim
- Requirements
- Commands
- Registries
- Screenshots
- Firewall (socket.dev)
- Configuration
Introduction
[:h mason-introduction][help-mason-introduction]
mason.nvim is a Neovim plugin that allows you to easily manage external editor tooling such as LSP servers, DAP servers,
linters, and formatters through a single interface. It runs everywhere Neovim runs (across Linux, macOS, Windows, etc.),
with only a small set of external requirements needed.
Packages are installed in Neovim's data directory ([:h standard-path][help-standard-path]) by default. Executables are
linked to a single bin/ directory, which mason.nvim will add to Neovim's PATH during setup, allowing seamless access
from Neovim builtins (LSP client, shell, terminal, etc.) as well as other 3rd party plugins.
For a list of all available packages, see .
Installation & Usage
[:h mason-quickstart][help-mason-quickstart]
Install using your plugin manager of choice. Setup is required:
lua
require("mason").setup()
mason.nvim is optimized to load as little as possible during setup. Lazy-loading the plugin, or somehow deferring the
setup, is not recommended.
Refer to the Configuration section for information about which settings are available.
Recommended setup for lazy.nvim
The following is the recommended setup when using lazy.nvim. It will set up the plugin for you, meaning you don't have
to call require("mason").setup() yourself.
lua
{
"mason-org/mason.nvim",
opts = {}
}
Requirements
[:h mason-requirements][help-mason-requirements]
mason.nvim relaxes the minimum requirements by attempting multiple different utilities (for example, wget,
curl, and Invoke-WebRequest are all perfect substitutes).
The _minimum_ recommended requirements are:
- neovim = 0.10.0
- For Unix systems:
- git(1)
- curl(1) or GNU wget(1)
- unzip(1)
- GNU tar (tar(1) or gtar(1) depending on platform)
- gzip(1)
- For Windows systems:
- pwsh or powershell
- git
- GNU tar
- One of the following:
- [7zip][7zip]
- [peazip][peazip]
- [archiver][archiver]
- [winzip][winzip]
- [WinRAR][winrar]
Note that mason.nvim will regularly shell out to external package managers, such as cargo and npm. Depending on
your personal usage, some of these will also need to be installed. Refer to :checkhealth mason for a full list.
[7zip]: https://www.7-zip.org/
[archiver]: https://github.com/mholt/archiver
[peazip]: https://peazip.github.io/
[winzip]: https://www.winzip.com/
[winrar]: https://www.win-rar.com/
Commands
[:h mason-commands][help-masonTop issues
#428Package does not run on NixOS48 comments · 2022-09-15#1286Automatically install npm30 comments · 2023-05-04#1578clangd on Ubuntu aarch64 is unsupported26 comments · 2023-12-15#445Add a :MasonUpdateAll command25 comments · 2022-09-19#1549Failed to install latest registry21 comments · 2023-11-03#1929Failed to run 'config' for mason.nvim14 comments · 2025-05-07#1777Ruby LSP does not work when using different versions of Ruby14 comments · 2024-08-26#2068install treesitter grammars13 comments · 2026-04-05
Discussions
#2116mason.nvim update tools from command line2 comments · 2026-10-06#2083How to disable mason from auto enabling lsp1 comments · 2026-05-09#2075How to install ripgrep using mason?1 comments · 2026-04-09#2073Supply chain attack mitigation?2 comments · 2026-04-06#2070cue highlighting/lsp isn't working1 comments · 2026-04-06#2067How to pin a version of specific package?1 comments · 2026-04-04#2062Failed to download registry archive.0 comments · 2026-02-23#2056Does anyone else have duplicate ruby_lsp clients?0 comments · 2026-01-08
Latest release
v2.3.1 v2.3.1 2026-06-112.3.1 (2026-06-11) Bug Fixes fs: implement rmrf natively via libuv (2098) (8838e7a) nuget: also support .cmd shims on Windows (2102) (16ba83b)