CloudBoosterDocs
Troubleshooting

Install errors

Common errors when installing the cbx CLI and how to fix them.

Install errors

cbx: command not found

The CLI installed, but your shell can't find it on PATH.

Fix (macOS, Homebrew):

brew --prefix cloudbooster/tap/cbx-cli
# /opt/homebrew/Cellar/cbx-cli/...
echo $PATH | tr ':' '\n' | grep -q homebrew || \
  echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && \
  source ~/.zshrc

Fix (Linux, manual install):

sudo install -m 0755 ~/Downloads/cbx /usr/local/bin/cbx
which cbx

Fix (Windows, Scoop):

scoop which cbx-cli
# if blank: scoop bucket add cloudbooster https://github.com/cloudbooster/scoop-bucket
#           scoop install cbx-cli

Error: x86_64 binary on arm64 macOS (or vice versa)

You installed the wrong architecture.

file $(which cbx)
# /opt/homebrew/bin/cbx: Mach-O 64-bit executable arm64

If it's the wrong arch for your machine:

brew uninstall cbx-cli
brew install cloudbooster/tap/cbx-cli   # Homebrew picks the right arch

Manual installs: re-download the matching artifact from the release page.

Homebrew tap fails to add

Error: cloudbooster/tap is a shallow clone.

Or:

Error: Failure while executing; `git clone https://...` exited with 128.

The CB tap may not be public yet (or may have moved). Until launch, prefer the manual install:

curl -L https://github.com/cloudbooster/cbx-cli/releases/latest/download/cbx-darwin-arm64 \
  -o /usr/local/bin/cbx
chmod +x /usr/local/bin/cbx
cbx version

cbx version prints something old after upgrade

You probably have two binaries on PATH. Find them:

which -a cbx
# /opt/homebrew/bin/cbx
# /usr/local/bin/cbx          ← stale manual install

Delete the stale one and re-hash:

sudo rm /usr/local/bin/cbx
hash -r        # bash/zsh
rehash         # fish
cbx version

TLS certificate errors during install

curl: (60) SSL certificate problem: unable to get local issuer certificate

You're behind a corporate proxy that's MITM'ing TLS, or your CA bundle is stale.

Quick fix (corporate cert):

export SSL_CERT_FILE=/path/to/your/corporate-ca-bundle.pem
brew install cloudbooster/tap/cbx-cli

Fix (stale CA on macOS):

brew install ca-certificates
brew postinstall ca-certificates

See also

Previous

Troubleshooting

Next

AWS connection errors

On this page