push command (NuGet CLI)

  • 2 minutes to read

Applies to: package publishing • Supported versions: all; 4.1.0+ required for nuget.org

Important

To push packages to nuget.org you must use nuget.exe v4.1.0+, which implements the required NuGet protocols.

Pushes a package to a package source and publishes it.

NuGet's default configuration is obtained by loading %AppData%\NuGet\NuGet.Config (Windows) or ~/.nuget/NuGet/NuGet.Config (Mac/Linux), then loading any Nuget.Config or .nuget\Nuget.Config files starting from root of drive and ending in current directory (see Common NuGet configurations)

Usage

nuget push <packagePath> [options]

where <packagePath> identifies the package to push to the server.

Options

Option Description
ApiKey The API key for the target repository. If not present, the one specified in the config file is used.
ConfigFile The NuGet configuration file to apply. If not specified, %AppData%\NuGet\NuGet.Config (Windows) or ~/.nuget/NuGet/NuGet.Config (Mac/Linux) is used.
DisableBuffering Disables buffering when pushing to an HTTP(s) server to decrease memory usages. Caution: when this option is used, integrated Windows authentication might not work.
ForceEnglishOutput (3.5+) Forces nuget.exe to run using an invariant, English-based culture.
Help Displays help information for the command.
NonInteractive Suppresses prompts for user input or confirmations.
NoSymbols (3.5+) If a symbols package exists, it will not be pushed to a symbol server.
Source Specifies the server URL. NuGet identifies a UNC or local folder source and simply copies the file there instead of pushing it using HTTP. Also, starting with NuGet 3.4.2, this is a mandatory parameter unless the NuGet.Config file specifies a DefaultPushSource value (see Configuring NuGet behavior).
SkipDuplicate (5.1+) If a package and version already exists, skip it and continue with the next package in the push, if any.
SymbolSource (3.5+) Specifies the symbol server URL; nuget.smbsrc.net is used when pushing to nuget.org
SymbolApiKey (3.5+) Specifies the API key for the URL specified in -SymbolSource.
Timeout Specifies the timeout, in seconds, for pushing to a server. The default is 300 seconds (5 minutes).
Verbosity Specifies the amount of detail displayed in the output: normal, quiet, detailed.

Also see Environment variables

Examples

nuget push foo.nupkg

nuget push foo.symbols.nupkg

nuget push foo.nupkg -Timeout 360

nuget push *.nupkg

nuget.exe push -source \\mycompany\repo\ mypackage.1.0.0.nupkg

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -Source https://api.nuget.org/v3/index.json

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -src https://customsource/

:: In the example below -SkipDuplicate will skip pushing the package if package "Foo" version "5.0.2" already exists on NuGet.org
nuget push Foo.5.0.2.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -src https://api.nuget.org/v3/index.json -SkipDuplicate