Environment Variables

All environment variables that control the install script and the openboot CLI.

Install Script Variables

These are used when running the curl | bash install command.

Variable	Description	Default
`OPENBOOT_VERSION`	Install a specific version instead of latest	Latest release
`OPENBOOT_INSTALL_DIR`	Where to put the binary	`~/.openboot/bin`
`OPENBOOT_DRY_RUN`	Set to `true` to preview without changes	—
`OPENBOOT_SKIP_CHECKSUM`	Set to `true` to skip SHA256 verification	—

Install a specific version:

OPENBOOT_VERSION=0.3.1 curl -fsSL https://openboot.dev/install.sh | bash

Install to a custom directory:

OPENBOOT_INSTALL_DIR=~/.local/bin curl -fsSL https://openboot.dev/install.sh | bash

Preview the install script without making changes:

OPENBOOT_DRY_RUN=true curl -fsSL https://openboot.dev/install.sh | bash

These are used by the openboot binary at runtime.

Variable	Description
`OPENBOOT_GIT_NAME`	Git user name — only read in `--silent` mode (required if Git isn’t configured)
`OPENBOOT_GIT_EMAIL`	Git user email — only read in `--silent` mode (required if Git isn’t configured)
`OPENBOOT_PRESET`	Default preset to use (overridden by `--preset` flag)
`OPENBOOT_USER`	Default remote config to use (overridden by `--user` flag)
`OPENBOOT_DOTFILES`	Dotfiles repository URL (overridden by config’s `dotfiles_repo`)
`OPENBOOT_API_URL`	Override the API base URL (default: `https://openboot.dev`)
`OPENBOOT_DISABLE_AUTOUPDATE`	Set to `1` to disable auto-update checks

Silent install with Git identity:

OPENBOOT_GIT_NAME="Your Name" OPENBOOT_GIT_EMAIL="you@example.com" 
  openboot --preset developer --silent

Set a default preset so openboot always starts with it:

export OPENBOOT_PRESET=developer
openboot  # launches TUI with developer preset pre-selected

These aren’t environment variables, but useful to know:

Path	What’s There
`~/.openboot/bin/openboot`	The OpenBoot binary (one-line installer only)
`~/.openboot/auth.json`	Auth token (after `openboot login` or snapshot upload)
`~/.openboot/snapshot.json`	Local snapshot (when using `--local`)
`~/.openboot/config.json`	Auto-update settings
`~/.openboot/install_state.json`	Tracks what was installed and when
`~/.openboot/state.json`	UI reminder state
`~/.openboot/update_state.json`	Auto-update check state
`~/.dotfiles/`	Cloned dotfiles repo (when configured)