1dotnet tool install command(1)     .NET Core    dotnet tool install command(1)
2
3
4

dotnet tool install

NAME

7       dotnet  tool  install - Installs the specified .NET Core Global Tool on
8       your machine.
9

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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)
Impressum