Reference

CLI Installation

CLI Installation

The BA CLI is a command-line interface tool for managing your infrastructure and services.

Prerequisites#

  • Node.js 18+ or
  • Go 1.19+ or
  • Docker (for containerized installation)

Installation Methods#

1
npm install -g @ba/cli

Option 2: Install via Go#

1
go install github.com/ba/cli@latest

Option 3: Install via Docker#

1
docker pull ba/cli:latest
2
alias ba='docker run --rm -it ba/cli'

Option 4: Download Binary#

Download the appropriate binary for your platform from the releases page.

Linux/macOS#

1
curl -L https://github.com/ba/cli/releases/latest/download/ba-cli-linux-amd64 -o ba
2
chmod +x ba
3
sudo mv ba /usr/local/bin/

Windows#

1
Invoke-WebRequest -Uri "https://github.com/ba/cli/releases/latest/download/ba-cli-windows-amd64.exe" -OutFile "ba.exe"

Verification#

Verify the installation:

1
ba --version
2
ba --help

Configuration#

After installation, configure the CLI with your credentials:

1
ba login
2
ba config set-context <your-context>

Upgrading#

To upgrade to the latest version:

1
# npm
2
npm update -g @ba/cli
3
4
# Go
5
go install github.com/ba/cli@latest
6
7
# Docker
8
docker pull ba/cli:latest

Troubleshooting#

Permission Denied#

If you get a permission error, make sure the binary is executable:

1
chmod +x ba

Command Not Found#

Add the installation directory to your PATH or use the full path to the binary.

Proxy Issues#

If you're behind a proxy, configure your environment variables:

1
export HTTP_PROXY=http://proxy.company.com:8080
2
export HTTPS_PROXY=http://proxy.company.com:8080

Last updated: 2026-01-01