This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

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.

Install west.

On Linux:
```
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 zephyrproject parent directory, and change directory there.

On Linux and macOS:
```
mkdir zephyrproject
mv zephyr zephyrproject
cd zephyrproject
```
On Windows cmd.exe:
```
mkdir zephyrproject
move zephyr zephyrproject
chdir zephyrproject
```
The name zephyrproject is 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
```
This creates 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:
```
west update
```
Make sure to run this command whenever you pull zephyr. Otherwise, your local repositories will get out of sync. (Run west list for current information on these repositories.)

You are done: zephyrproject is now set up to use west.