1dotnet tool install command(1) .NET Core dotnet tool install command(1)
2
3
4
7 dotnet tool install - Installs the specified .NET Core Global Tool on
8 your machine.
9
11 dotnet tool install <PACKAGE_NAME> <-g|--global> [--add-source] [--configfile] [--framework] [-v|--verbosity] [--version]
12 dotnet tool install <PACKAGE_NAME> <--tool-path> [--add-source] [--configfile] [--framework] [-v|--verbosity] [--version]
13 dotnet tool install <-h|--help>
14
16 The dotnet tool install command provides a way for you to install .NET
17 Core Global Tools on your machine. To use the command, you either have
18 to specify that you want a user-wide installation using the --global
19 option or you specify a path to install it using the --tool-path op‐
20 tion.
21
22 Global Tools are installed in the following directories by default when
23 you specify the -g (or --global) option:
24
25 OS Path
26 ──────────────────────────────────
27 Linux/macOS $HOME/.dotnet/tools
28 Windows %USERPROFILE%\.dot‐
29 net\tools
30
31 Arguments
32 PACKAGE_NAME
33
34 Name/ID of the NuGet package that contains the .NET Core Global Tool to
35 install.
36
38 --add-source <SOURCE>
39
40 Adds an additional NuGet package source to use during installation.
41
42 --configfile <FILE>
43
44 The NuGet configuration (nuget.config) file to use.
45
46 --framework <FRAMEWORK>
47
48 Specifies the target framework to install the tool for. By default,
49 the .NET Core SDK tries to choose the most appropriate target frame‐
50 work.
51
52 -g|--global
53
54 Specifies that the installation is user wide. Can’t be combined with
55 the --tool-path option. If you don’t specify this option, you must
56 specify the --tool-path option.
57
58 -h|--help
59
60 Prints out a short help for the command.
61
62 --tool-path <PATH>
63
64 Specifies the location where to install the Global Tool. PATH can be
65 absolute or relative. If PATH doesn’t exist, the command tries to cre‐
66 ate it. Can’t be combined with the --global option. If you don’t
67 specify this option, you must specify the --global option.
68
69 -v|--verbosity <LEVEL>
70
71 Sets the verbosity level of the command. Allowed values are q[uiet],
72 m[inimal], n[ormal], d[etailed], and diag[nostic].
73
74 --version <VERSION_NUMBER>
75
76 The version of the tool to install. By default, the latest stable
77 package version is installed. Use this option to install preview or
78 older versions of the tool.
79
81 Installs the dotnetsay Global Tool in the default location:
82
83 dotnet tool install -g dotnetsay
84
85 Installs the dotnetsay Global Tool on a specific Windows folder:
86
87 dotnet tool install dotnetsay --tool-path c:\global-tools
88
89 Installs the dotnetsay Global Tool on a specific Linux/macOS folder:
90
91 dotnet tool install dotnetsay --tool-path ~/bin
92
93 Installs version 2.0.0 of the dotnetsay Global Tool:
94
95 dotnet tool install -g dotnetsay --version 2.0.0
96
97 See also
98 · .NET Core Global Tools
99
100
101
102 dotnet tool install command(1)