Moving to West¶
To convert a “pre-west” Zephyr setup on your computer to west, follow these steps. If you are starting from scratch, use the Getting Started Guide instead. See Troubleshooting West for advice on common issues.
pip3 install --user -U west
On Windows and macOS:
pip3 install -U west
For details, see Installing west.
Move your zephyr repository to a new
zephyrprojectparent directory, and change directory there.
On Linux and macOS:
mkdir zephyrproject mv zephyr zephyrproject cd zephyrproject
mkdir zephyrproject move zephyr zephyrproject chdir zephyrproject
zephyrprojectis recommended, but you can choose any name with no spaces anywhere in the path.
Create a west workspace using the zephyr repository as a local manifest repository:
west init -l zephyr
zephyrproject/.west, marking the root of your workspace, and does some other setup. It will not change the contents of the zephyr repository in any way.
Clone the rest of the repositories used by zephyr:
Make sure to run this command whenever you pull zephyr. Otherwise, your local repositories will get out of sync. (Run
west listfor current information on these repositories.)
You are done:
zephyrproject is now set up to use west.