Skip to content
Browse files

doc: getting started: Use -U when installing west

For users that have an older version of west already installed, it is
useful to include `-U` in the getting started guide, otherwise the
instructions will fail to work depending on the state of the machine.

Fixes #18132

Signed-off-by: Carles Cufi <>
  • Loading branch information...
carlescufi authored and aescolar committed Aug 8, 2019
1 parent 2be13ca commit a8d17437a6b34fc6e7a9bbec7d7163eae3550fb5
Showing with 7 additions and 2 deletions.
  1. +7 −2 doc/getting_started/index.rst
@@ -39,6 +39,11 @@ information about pip\ [#pip]_, including this `information on -\\-user`_.
- On Windows, see the Installing Packages information on ``--user`` if you
require using this option.

On all operating systems, the ``-U`` flag installs or updates the package if the
package is already installed locally but a more recent version is available. It
is good practice to use this flag if the latest version of a package is

Install the required tools

@@ -68,10 +73,10 @@ First, install ``west`` using ``pip3``:
.. code-block:: console

# Linux
pip3 install --user west
pip3 install --user -U west

# macOS (Terminal) and Windows (cmd.exe)
pip3 install west
pip3 install -U west

See :ref:`west-install` for additional details on installing west.

0 comments on commit a8d1743

Please sign in to comment.
You can’t perform that action at this time.