Operating System Setup

I assume a fresh machine; feel free to skip steps you’ve nailed already.

Common ground (macOS & Linux)

1. Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Homebrew manages everything from git to postgresql.

Add Brew to PATH (the installer prints the snippet) and run brew doctor until you’re "ready to brew".

2. Rust toolchain

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

rustup installs stable Rust plus cargo, the build system. Leave default targets.

3. Oh My Zsh (optional but nice)

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Gives you a battery‑included zsh config, plugins, and a pretty prompt.

Enable the git and rust plugins in ~/.zshrc for sweet autocompletions.

macOS notes

• Install Xcode Command‑Line Tools:

xcode-select --install

• Docker Desktop

Linux (Ubuntu)

sudo apt update && sudo apt install build-essential curl file git
sudo apt install zsh docker.io
chsh -s $(which zsh)
sudo usermod -aG docker $USER

Log out/in to refresh group membership.

Verify setup

rustc --version
cargo new sanity-check && cd sanity-check && cargo run
git --version
docker --version