Installing NuGet client tools
Looking to install a package? See Quickstart - Use a package.
There are two primary tools available to help you build, publish and consume NuGet packages:
- The NuGet CLI is the command-line utility for Windows that provides all NuGet capabilities; it can also be run on Mac OSX and Linux using Mono, or through the .NET Core CLI (
The NuGet Package Manager in Visual Studio (Windows only) is a GUI tool for managing packages and includes a PowerShell console through which you can use certain NuGet commands directly within Visual Studio. The Package Manager UI and Console are both included with Visual Studio (on Windows) 2012 and later and can be installed manually for earlier versions.
With Visual Studio for Mac, NuGet capabilities are built in directly. See Including a NuGet package in your project for a walkthrough.
Visual Studio Code at present does not have any built-in NuGet support. Use the NuGet CLI or the dotnet CLI.
The NuGet CLI and Package Manager both support the following operations:
- Search packages
- Install packages
- Update packages
- Uninstall packages
- Restore packages (UI only in the Package Manager)
- Manage NuGet sources
The following capabilities are supported only in the NuGet CLI:
- Manage packages (nuget.org or private feed)
- Create packages
- Publish packages
- Manage Nuget.Config
- Manage the NuGet cache
- Replicating a package
Another good tool is the NuGet Package Explorer, an open-source, stand-alone tool to visually explore, create, and edit NuGet packages. It's very helpful, for example, to make experimental changes to a package structure without having to rebuild the package each time. The cross-platform .NET Core CLI toolchain, used for developing .NET Core applications, supports several NuGet commands, such as delete, locals, push, pack, and restore.
The NuGet command-line interface provides access to all NuGet capabilities, and can be run on Windows, Mac OSX, and Linux as described in the following sections.
- On Mac and Linux, install Mono 4.4.2 or later.
- Visit nuget.org/downloads and select the version of NuGet you want.
- Each download is the
nuget.exefile directly. Instruct your browser to save the file to a folder of your choice. The file is not an installer; running it from the browser won't show anything.
- Add the folder where you placed
nuget.exeto your PATH environment variable to use the CLI tool from anywhere.
With NuGet 1.4+, you can use
nuget update -self to update your existing nuget.exe to the latest version.
choco install nuget.commandline
Visual Studio: Install the NuGet.CommandLine package from the Package Manager Console in Visual Studio.
For NuGet 2.x users: Because of breaking changes introduced in NuGet 3.2, https://nuget.org/nuget.exe points to the latest stable NuGet 2.x release to prevent continuous integration systems from potentially breaking.
Mac OSX and Linux
On Mac OSX and Linux, there are two ways to run the NuGet CLI:
Install the .NET Core SDK, which includes the core NuGet capabilities. Downloads are also listed on github.com/dotnet/cli. If you need fuller capabilities, then use the second option below to use
Commands tested to work:
- pack: works with
.nuspecfiles but not with project files.
- restore: works with
project.jsonfiles but not with solution (
- pack: works with
Commands that do not work:
NuGet Package Manager in Visual Studio
The NuGet Package Manager is included in every edition of Visual Studio on Windows, 2012 and later. It includes the Package Manager UI (reference), and the Package Manager Console through which you can access tools that come with certain packages (reference).
The Visual Studio 2017 installer includes the NuGet Package Manager with any workload that employs .NET. To install separately, or to verify that the Package Manager is installed, run the Visual Studio 2017 installer and check the option under Individual Components > Code tools > NuGet package manager.
The console requires PowerShell 2.0, which will already be installed on Windows 7 or higher and Windows Server 2008 R2 or higher.
Package Manager Console commands also work only within Visual Studio on Windows. Use the NuGet CLI outside of that environment, including with Visual Studio for Mac and Visual Studio Code.
Package Manager installation for Visual Studio 2010 and earlier
These steps are not necessary for Visual Studio 2012 and later, which already include the Package Manager.
- In Visual Studio 2010 and earlier, click Tools > Extension and Updates.
- Navigate to Online, then search for "NuGet Package Manager for Visual Studio" and click Download.
- In the Installer dialog box, click Install.
- When installation is complete, restart Visual Studio.
If you're unable to use the Extensions and Updates dialog in Visual Studio (for example, its blocked by a proxy), you can download extensions for Visual Studio 2013 and 2015 directly at https://dist.nuget.org/index.html.
Updating the Package Manager
For Visual Studio 2015 Update 2 and later, the Package Manager is automatically updated to the latest stable release.
For Visual Studio 2015 Update 1 and earlier, select the Tools > Extensions and Updates command and click on the Updates tab to see if a new version of the Package Manager is available.
If you'd like to preview upcoming NuGet features, install the Visual Studio 2017 Preview, which works side-by-side with stable releases of Visual Studio.
Note that the previous NuGet Beta Channel (
https://dotnet.myget.org/F/nuget-beta/vsix/) for Visual Studio 2015 is no longer used.
To report problems with any release of NuGet or to share ideas, open an issue on the NuGet GitHub repository.