FAQ

Is OpenBoot free?

Yes. Free and open source (MIT license). Create configs, snapshot your setup, share with your team—no cost. Team management features (org accounts, access controls) might have paid tiers later.

Why not just use Homebrew directly?

Homebrew installs packages. OpenBoot installs packages and configures your shell, links dotfiles, and applies macOS preferences. All in one run with a TUI to pick what you want.

If you’re fine managing those separately, you don’t need this. If you’d rather automate it, try OpenBoot.

Should I use Homebrew or the one-line installer?

Use Homebrew (brew install openboot) if you:

• Already have Homebrew installed
• Want cleaner updates (brew upgrade openboot)
• Prefer package managers and the OpenBoot CLI over ad-hoc scripts

Use the one-line installer if you:

• Don’t have Homebrew yet (it installs Homebrew for you)
• Want the absolute fastest setup on a fresh Mac
• Are running in CI/automation environments

Both methods install the exact same binary.

Is the one-line installer safe?

Fair question. Here’s how it works:

• Install script is open source—review it at github.com/openbootdotdev/openboot
• Hosted on openboot.dev (Cloudflare Workers), served over HTTPS
• Zero telemetry—no analytics, no tracking, nothing phones home
• Installs OpenBoot via Homebrew (brew install openbootdotdev/tap/openboot), which handles integrity verification
• You can inspect the script before running it:

curl -fsSL https://openboot.dev/install.sh > install.sh
cat install.sh  # Review the script
bash install.sh  # Run it after review

If you prefer, install via Homebrew instead (see above).

What about install counts on shared configs?

If you share a config publicly on the Explore page, we display an install count. This is not telemetry in the traditional sense:

• Anonymous — we don’t track who installed it, only that someone did
• Opt-in — only happens when you actively set visibility to “Public”
• No personal data — no IP addresses, no user agents, no system info collected
• Zero tracking — we don’t follow your behavior, clicks, or usage patterns

“Zero telemetry” means the OpenBoot CLI never reports back to us. It doesn’t track what you install, what commands you run, or any system information. Install counts are simply a counter for configs you chose to share publicly with the community.

Think of it like GitHub’s star count — it shows popularity, but doesn’t track individual users.

What if I already have Homebrew?

OpenBoot detects existing Homebrew installs and skips the setup. It also skips already-installed packages — only new ones get installed. Re-running is fast and safe.

Can I use it without an account?

Yes. No account needed for:

• Installing with presets (minimal, developer, full)
• Using the interactive TUI
• Running openboot snapshot --local or --json

An account (GitHub or Google OAuth) is needed to:

• Upload configs to openboot.dev and share them via URL
• Install private configs (run openboot login first)

How do I update OpenBoot?

brew upgrade openboot

Or use the built-in self-update:

openboot update --self

Your configs, snapshots, and auth tokens are unaffected by updates.

How do I uninstall OpenBoot?

1. Remove the binary

Both installation methods use Homebrew, so the uninstall is the same:

brew uninstall openboot
brew untap openbootdotdev/tap

2. Remove OpenBoot data

rm -rf ~/.openboot

This deletes your auth token, local snapshots, install state, and update config. If you want to keep anything, back it up first — see File Locations for what’s in there.

3. Clean up shell config (optional)

If OpenBoot configured your shell, open ~/.zshrc and remove the block starting with # OpenBoot additions — it includes Homebrew init, PATH changes, CLI aliases, and tool integrations. If you’re not sure which lines, look for the block between # OpenBoot additions and the next blank line or section.

If you used dotfiles linking, OpenBoot created .openboot.bak backups of your original files. To restore them:

# Example: restore a backed-up .zshrc
mv ~/.zshrc.openboot.bak ~/.zshrc

4. Packages and apps (optional)

OpenBoot doesn’t remove Homebrew packages or casks when you uninstall it — they’re yours to keep. If you want to remove packages that were installed via OpenBoot, use brew uninstall <package> individually.

Where is my data stored?

Configs are unlisted by default — not listed on your profile, but the install URL works if shared. You can set them to public (listed on profile) or private (requires authentication to install). See Custom Configs — Visibility for details.

What shell does OpenBoot set up?

Zsh with Oh-My-Zsh:

• Plugins: git, zsh-autosuggestions, zsh-syntax-highlighting
• A clean, informative theme
• Useful developer aliases

If you already have Oh-My-Zsh, OpenBoot merges its recommendations without overwriting your config. If you manage your shell yourself, use --shell skip.

Does it work on Linux?

Not yet. OpenBoot is macOS-only. Linux support is being explored.

Can I use it with my existing dotfiles?

Yes. Set your dotfiles repo URL in your config and OpenBoot will clone and link it with GNU Stow. See Dotfiles & Shell for details.

Your existing dotfiles repo structure works as-is — OpenBoot doesn’t require any special format.