03 Engineering / Cloudberrie Developer Workstation
03 Engineering

Cloudberrie Developer Workstation

The approved Mac setup for Cloudberrie engineering and platform operations.

Document: ENG-001Type: SOPStatus: ApprovedOwner: Cloudberrie StudioVersion: 4.2.0Updated: 2026-07-17

Approved Local Structure

/Users/cloudberrie/Documents/Cloudberrie/
├── Projects/
│   ├── cb-website/
│   ├── cb-manual/
│   ├── cb-studio-board/
│   ├── cb-eventlumi/
│   └── cb-aifa/
├── Assets/
├── Backups/
├── Documentation/
└── Archive/

Install Homebrew

Use the official installer in Terminal:

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

Run the PATH commands printed by the installer. On the current Mac, Homebrew installed under /usr/local/bin and the installer supplied:

echo >> /Users/cloudberrie/.zprofile
echo 'eval "$(/usr/local/bin/brew shellenv zsh)"' >> /Users/cloudberrie/.zprofile
eval "$(/usr/local/bin/brew shellenv zsh)"

Validate:

brew --version

Install and Authenticate GitHub CLI

brew install gh
gh --version
gh auth login

Select GitHub.com, HTTPS, authenticate Git, and browser login. Validate and configure Git:

gh auth status
gh auth setup-git
Invalid keyring token: run gh auth logout -h github.com -u cb-engops, then repeat gh auth login.

Repository-Specific Git Identity

cd /Users/cloudberrie/Documents/Cloudberrie/Projects/cb-website
git config user.name "Cloudberrie Engineering"
git config user.email "engineering@cloudberrie.com"

Validate:

git config user.name
git config user.email

Workstation Validation