1dotnet nuget push command(1)       .NET Core      dotnet nuget push command(1)
2
3
4

dotnet nuget push

6       This topic applies to: ✓ .NET Core 1.x SDK and later versions
7

NAME

9       dotnet nuget push - Pushes a package to the server and publishes it.
10

SYNOPSIS

12              dotnet nuget push [<ROOT>] [-d|--disable-buffering] [--force-english-output] [--interactive] [-k|--api-key] [-n|--no-symbols]
13                  [--no-service-endpoint] [-s|--source] [-sk|--symbol-api-key] [-ss|--symbol-source] [-t|--timeout]
14              dotnet nuget push [-h|--help]
15

DESCRIPTION

17       The  dotnet  nuget push command pushes a package to the server and pub‐
18       lishes it.  The push command uses server and credential  details  found
19       in  the  system’s NuGet config file or chain of config files.  For more
20       information on config files, see Configuring NuGet  Behavior.   NuGet’s
21       default configuration is obtained by loading %AppData%.config (Windows)
22       or $HOME/.local/share (Linux/macOS), then loading any  nuget.config  or
23       .nuget.config starting from the root of drive and ending in the current
24       directory.
25
26   Arguments
27       · ROOT
28
29         Specifies the file path to the package to be pushed.
30

OPTIONS

32       · -d|--disable-buffering
33
34         Disables buffering when pushing to an HTTP(S) server to reduce memory
35         usage.
36
37       · --force-english-output
38
39         Forces  the application to run using an invariant, English-based cul‐
40         ture.
41
42       · -h|--help
43
44       Prints out a short help for the command.
45
46       · --interactive
47
48         Allows the command to block and requires manual action for operations
49         like authentication.  Option available since .NET Core 2.2 SDK.
50
51       · -k|--api-key <API_KEY>
52
53         The API key for the server.
54
55       · -n|--no-symbols
56
57         Doesn’t push symbols (even if present).
58
59       · --no-service-endpoint
60
61         Doesn’t  append “api/v2/package” to the source URL.  Option available
62         since .NET Core 2.1 SDK.
63
64       · -s|--source <SOURCE>
65
66         Specifies the server URL.  This option is  required  unless  Default‐
67         PushSource config value is set in the NuGet config file.
68
69       · -sk|--symbol-api-key <API_KEY>
70
71         The API key for the symbol server.
72
73       · -ss|--symbol-source <SOURCE>
74
75         Specifies the symbol server URL.
76
77       · -t|--timeout <TIMEOUT>
78
79         Specifies  the  timeout for pushing to a server in seconds.  Defaults
80         to 300 seconds (5 minutes).  Specifying 0 (zero seconds) applies  the
81         default value.
82

EXAMPLES

84       · Pushes foo.nupkg to the default push source, specifying an API key:
85
86                dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a
87
88       · Push foo.nupkg to the custom push source https://customsource, speci‐
89         fying an API key:
90
91                dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://customsource/
92
93       · Pushes foo.nupkg to the default push source:
94
95                dotnet nuget push foo.nupkg
96
97       · Pushes foo.symbols.nupkg to the default symbols source:
98
99                dotnet nuget push foo.symbols.nupkg
100
101       · Pushes foo.nupkg to the default push source, specifying a  360-second
102         timeout:
103
104                dotnet nuget push foo.nupkg --timeout 360
105
106       · Pushes  all .nupkg files in the current directory to the default push
107         source:
108
109                dotnet nuget push *.nupkg
110
111                [!NOTE] If this command doesn’t work, it might be due to a bug
112                that  existed  in older versions of the SDK (.NET Core 2.1 SDK
113                and earlier versions).  To fix this, upgrade your SDK  version
114                or  run  the  following  command  instead:  dotnet  nuget push
115                **/*.nupkg
116

AUTHORS

118       karann-msft.
119
120
121
122                                                  dotnet nuget push command(1)