Installing a toolchain

nRF Util

tags
nRF Util

To install a specific toolchain version, complete the following steps:

  1. Get the latest list index of toolchains by running the search command:
    nrfutil toolchain-manager search
    
  2. Optionally, check the installation directory by running the following command:
    nrfutil toolchain-manager config --show
    
    If you want to install at a different location, you can specify it in the next step.
  3. Install the chosen toolchain version by using one of the following options:

    • Install at the current installation location: run the install command with the --ncs-version flag. For example, the following command installs the toolchain for the nRF Connect SDK v2.6.2:

      nrfutil toolchain-manager install --ncs-version v2.6.2
      
    • Install only once at a different installation location: run the install command with the --ncs-version and the --install-dir flags. For example, the following command installs the toolchain for the nRF Connect SDK v2.6.2 in the toolchains directory at C:\\test on Windows:

      nrfutil toolchain-manager install --ncs-version v2.6.2 --install-dir C:\\test
      
      This command overrides the configured location just for this single command. (Overriding with flags does not support completion.)

The install command features completion for toolchains that are available to install. These values are based on the most recently cached copy of the index (for the index given by the current configuration value of toolchain-index).

Alternatively to the --ncs-version flag, you can also use the following flags:

  • --toolchain-bundle-id - which takes the SHA of the toolchain bundle, if you have received one.
  • --toolchain-bundle - which takes the path to the toolchain bundle, if you have downloaded one locally.

After installing your toolchain for the first time, you should get the corresponding nRF Connect SDK version.