zephyr-bootstrap

Dead simple Zephyr RTOS setup script for Arch Linux, macOS, and Debian/Ubuntu.

What it does

• installs all the dependencies you need
• sets up python venv
• grabs zephyr and west
• installs the sdk
• builds hello_world to make sure everything works

Basically follows the official getting started guide but automated so you don't have to copy-paste 50 commands.

Usage

curl -fsSL https://raw.githubusercontent.com/heronet/zephyr-bootstrap/master/setup.sh | bash

Or clone and run:

git clone https://github.com/heronet/zephyr-bootstrap.git
cd zephyr-bootstrap
chmod +x setup.sh
./setup.sh

It'll ask you where to install (default: ~/zephyrproject) and whether you want the SDK.

After install

source ~/.zshenv  # or ~/.bashrc for bash users
source ~/zephyrproject/.venv/bin/activate
cd ~/zephyrproject/zephyr
west build -b native_sim samples/hello_world
west build -t run

Requirements

• Arch Linux, macOS 12+, Debian 11+, or Ubuntu 20.04+
• CMake 3.20.5+
• Python 3.10+
• Internet connection (it downloads stuff)

Troubleshooting

If something breaks, check ~/.zshenv.backup.* or ~/.bashrc.backup.* - the script backs up your shell config before modifying it.

For ARM64 Ubuntu, gcc-multilib gets skipped automatically since it's not available.

The script writes to ~/.zshenv (zsh) or ~/.bashrc (bash) so environment variables are available in all new shells.

License

GPL-3.0-or-later See LICENSE file for details.