Skip to main content

Troubleshooting CLI Installation

Homebrew Issues​

"Formula not found"​

# Update Homebrew
brew update

# Re-tap the repository
brew untap surestage/tap
brew tap surestage/tap
brew install surestage

Permission Errors on macOS​

# If you get permission denied
sudo chown -R $(whoami) /usr/local/bin
brew install surestage

Go Install Issues​

"Command not found" after install​

Ensure $GOPATH/bin is in your PATH:

# Add to ~/.zshrc or ~/.bashrc
export PATH=$PATH:$(go env GOPATH)/bin

Version Mismatch​

# Check Go version (requires 1.21+)
go version

# Install specific CLI version
go install github.com/surestage/surestage-cli@v1.0.0

Binary Download Issues​

macOS: "App can't be opened"​

macOS Gatekeeper may block unsigned binaries:

# Remove quarantine attribute
xattr -d com.apple.quarantine ./surestage

Linux: Permission Denied​

chmod +x ./surestage
sudo mv ./surestage /usr/local/bin/