sdk-manager
command quick guidenRF Util’s sdk-manager
is a CLI tool for managing SDK
and toolchain installations for the nRF
Connect SDK.
Each version of the nRF Connect SDK has an associated toolchain, which includes tools and modules specific to the nRF Connect SDK that are required to build nRF Connect SDK samples and applications. Multiple SDK versions can share the same toolchain version (for example, the nRF Connect SDK v2.4.1 is reusing the toolchain v2.4.0).
Note: sdk-manager
is set to replace the
toolchain-manager
nRF Util command. The
sdk-manager
command is able to detect the toolchains
installed with toolchain-manager
.
The sdk-manager
has its own, dedicated installation
directory for downloading and installing SDKs and toolchains. Its
location depends on your operating system:
Operating System | Default installation location for bundles | Notes |
---|---|---|
Windows | C:\ncs |
Can be changed using a flag or permanently. |
Linux | $HOME/ncs (or ~/ncs ) |
Can be changed using a flag or permanently. |
macOS | /opt/nordic/ncs |
Cannot be changed - read why. |
For more information about how bundles are structured within this directory, see Installing and uninstalling with SDK manager.
To see the list of subcommands and available operations, run
nrfutil sdk-manager --help
.
Below are some basic usage examples of the sdk-manager
command.
The following command updates and prints the list of stable SDK bundles and their corresponding toolchain bundles that are available for download or installed on your machine (or both):
nrfutil sdk-manager search
The command outputs the list of versions and their status for the default or selected installation directory:
Version SDK Toolchain
v2.7.0 Installed Not Installed
v2.3.0 Not Installed Not Installed
v2.2.0 Not Installed Not Installed
v2.1.0 Not Installed Not Installed
v2.0.0 Not Installed Installed
You can install the SDK and toolchain versions that are
Available
. For the description of other possible statuses
and information about how to show all available SDKs and toolchains, see
Searching
for available SDKs and toolchains.
To install a specific version, use the
nrfutil sdk-manager install
command and specify the version
you want to install. For example, the following command installs both
the SDK bundles and its corresponding toolchain bundle for the nRF
Connect SDK v2.7.0:
nrfutil sdk-manager install v2.7.0
The installation can take several minutes.
If you have either an SDK or a toolchain bundle already installed, this command installs the missing bundle for the provided version. If the SDK version you are installing is reusing a toolchain version that you have already installed, the command will not install the toolchain again.
For more information about the install
command, see Installing
and uninstalling with SDK manager.
To remove both the SDK and its associated toolchain version, use the
top-level uninstall
subcommand.
For example, the following command removes both the SDK and toolchain v2.7.0 bundles:
nrfutil sdk-manager uninstall v2.7.0
If the toolchain version is used by other SDKs, the toolchain is not removed by this command.
You can also remove an SDK bundle or a toolchain bundle separately
using the sdk uninstall
or the
toolchain uninstall
subcommands, respectively. For more
information, see Uninstalling
only the SDK or the toolchain.
To check the configuration settings for sdk-manager
, run
the following command:
nrfutil sdk-manager config show
For more information, see the Configuration settings page.