Updating repositories and tools

After you install the nRF Connect SDK, regularly check for updates to repositories and tools. The west tool is updated regularly, like any other required Python dependency package.

You might also want to switch to a newer release or check out the latest state of development. However, if you work with a specific release of the nRF Connect SDK, you do not need to update your repositories, because the release will not change. For an overview of changes in the latest releases, see Release notes.

Updating the repositories

Use the method corresponding to the way you installed the nRF Connect SDK, as described in the following sections.

Updating in Visual Studio Code

The nRF Connect for VS Code extension lets you update the associated nRF Connect SDK repositories within the Source Control View. For detailed instructions, see the west module management page in the extension’s documentation.

Updating in Toolchain Manager

Note

The SDK versions available in Toolchain Manager are for specific releases. Updating the SDK repositories in Toolchain Manager might therefore be required only in exceptional situations.

If you installed the nRF Connect SDK automatically using the Toolchain Manager, complete the following steps to update the repositories in Toolchain Manager:

  1. Open the Toolchain Manager application in nRF Connect for Desktop.

  2. Click the button with the arrow pointing down next to the installed nRF Connect SDK version to expand the drop-down menu with options.

    The Toolchain Manager dropdown menu for the installed nRF Connect SDK version, cropped

    The Toolchain Manager dropdown menu options

  3. In the drop-down menu, click Update SDK.

Updating from command line

To manage the nrf repository (the manifest repository) from command line, use Git. To make sure that you have the latest changes, run git fetch origin to fetch the latest code from the sdk-nrf repository. Checking out a branch or tag in the nrf repository gives you a different version of the manifest file. Running west update updates the project repositories to the state specified in this manifest file.

Note

If you get an error message when running west, update west to the latest version. See Troubleshooting West in the Zephyr documentation for more information.

Examples of commands

To switch to release v2.4.2 of the nRF Connect SDK, enter the following commands in the ncs/nrf directory:

git fetch origin
git checkout v2.4.2
west update

To update to a particular revision (SHA), make sure that you have that particular revision locally before you check it out (by running git fetch origin):

git fetch origin
git checkout 224bee9055d986fe2677149b8cbda0ff10650a6e
west update

To switch to the latest state of development, enter the following commands:

git fetch origin
git checkout origin/main
west update

Note

Run west update every time you change or modify the current working branch (for example, when you pull, rebase, or check out a different branch). This will bring the project repositories to the matching revision defined by the manifest file.

Updating nRF Connect for VS Code extension

Visual Studio Code checks for extension updates and automatically installs them when they are available. After an extension is updated, Visual Studio Code prompts you to reload the application.

If you disabled automatic updates:

  1. Open the Extensions tab and locate the nRF Connect for VS Code extension.

  2. The Update button appears when an update is available. Click the button to install the update.

Updating toolchain in Toolchain Manager

If you installed the nRF Connect SDK automatically using the Toolchain Manager, complete the following steps to update the toolchain in Toolchain Manager:

  1. Open the Toolchain Manager application in nRF Connect for Desktop.

  2. Click the button with the arrow pointing down next to the installed nRF Connect SDK version to expand the drop-down menu with options.

    The Toolchain Manager dropdown menu for the installed nRF Connect SDK version, cropped

    The Toolchain Manager dropdown menu options

  3. In the drop-down menu, click Update toolchain.

Updating west from command line

To update west to the latest available version in the PyPi repository, run the following command in the command window:

pip3 install -U west