Skip to content

Commit 19ac9c2

Browse files
author
Kraig Brockschmidt
committed
Clarify OCX and Linux installation
1 parent 8996008 commit 19ac9c2

File tree

1 file changed

+34
-22
lines changed

1 file changed

+34
-22
lines changed

docs/Guides/Install-NuGet.md

Lines changed: 34 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: Installing NuGet | Microsoft Docs
55
author: kraigb
66
ms.author: kraigb
77
manager: ghogen
8-
ms.date: 1/9/2017
8+
ms.date: 4/4/2017
99
ms.topic: article
1010
ms.prod: nuget
1111
#ms.service:
@@ -32,7 +32,7 @@ ms.reviewer:
3232

3333
There are two primary tools available to help you build, publish and consume NuGet packages:
3434

35-
1. The [**NuGet CLI**](#nuget-cli) is the command-line utility that works on Windows, Mac OS X, and Linux and supports all NuGet capabilities.
35+
1. The [**NuGet CLI**](#nuget-cli) is the command-line utility for Windows that provides all NuGet capabilities; it can also be run on Mac OSX and Linux either through Mono or through the .NET Core CLI.
3636
1. The [**NuGet Package Manager in Visual Studio**](#nuget-package-manager-in-visual-studio) is a GUI tool for managing packages and includes a console through which you can use certain NuGet commands directly within Visual Studio. It's included with Visual Studio 2012 and later and can be installed manually for earlier versions.
3737

3838
Both support the following operations:
@@ -60,7 +60,11 @@ The following capabilities are supported only in the NuGet CLI:
6060

6161
## NuGet CLI
6262

63-
The NuGet CLI can be installed using any of the following methods:
63+
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.
64+
65+
### Windows
66+
67+
On Windows, the NuGet CLI can be installed using any of the following methods:
6468

6569
1. **nuget.org**: Download the latest version of the nuget.exe file from [nuget.org/downloads](https://nuget.org/downloads) and save it to an appropriate location on your machine. If desired, add that location to your PATH environment variable so you can NuGet from anywhere. (Note that the download is a single .exe file, so save it rather than running it from the browser.)
6670

@@ -80,25 +84,33 @@ The NuGet CLI can be installed using any of the following methods:
8084
>
8185
> Because there are a few breaking changes introduced in NuGet 3.2, [https://nuget.org/nuget.exe](https://nuget.org/nuget.exe) points to the latest stable NuGet 2.x release to prevent CI systems from potentially breaking at this time.
8286

83-
### Compatibility with Mono
84-
85-
Though not fully-supported as yet, the NuGet command-line executable (version 3.2 and above) will run on Mac OS X and Linux systems when the Mono runtime is installed with a few limitations:
86-
87-
- Commands tested to work:
88-
- Config
89-
- Delete
90-
- Help
91-
- Install
92-
- List
93-
- Push
94-
- SetApiKey
95-
- Sources
96-
- Spec
97-
- Partially-working commands:
98-
- Pack: works with `.nuspec` files but not with project files.
99-
- Restore: works with `packages.config` and `project.json` files but not with solution (`.sln`) files.
100-
- Commands that do not work:
101-
- Update
87+
<a name="compatibility-with-mono"></a>
88+
89+
## Mac OSX and Linux
90+
91+
On Mac OSX and Linux, there are two ways to run NuGet:
92+
93+
1. Install the [.NET Core SDK](https://www.microsoft.com/net/download/core), which includes NuGet capabilities. Downloads are also listed on [github.com/dotnet/cli](https://github.com/dotnet/cli).
94+
95+
1. Install [Mono](http://www.mono-project.com/docs/getting-started/install/) and then use the nuget.exe command-line executable for Windows (version 3.2 and later) from [nuget.org/downloads](https://nuget.org/downloads). Running NuGet on Mono is subject to the following limitations:
96+
97+
- Commands tested to work:
98+
- Config
99+
- Delete
100+
- Help
101+
- Install
102+
- List
103+
- Push
104+
- SetApiKey
105+
- Sources
106+
- Spec
107+
108+
- Partially-working commands:
109+
- Pack: works with `.nuspec` files but not with project files.
110+
- Restore: works with `packages.config` and `project.json` files but not with solution (`.sln`) files.
111+
112+
- Commands that do not work:
113+
- Update
102114

103115

104116
### Related topics

0 commit comments

Comments
 (0)