Skip to main content

Installation

Install the Cloud Cost Analyzer CLI on your system.

System Requirements​

  • OS: Linux (glibc 2.17+), macOS 11+ (Big Sur — Intel & Apple Silicon), Windows 10+ (via WSL or native)
  • Architecture: x86_64 or ARM64
  • Memory: 256 MB minimum, 512 MB recommended
  • Disk: 50 MB for the binary

The fastest way to install on Linux or macOS:

curl -sSL https://releases.dragonfractal.com/install.sh | sh

This detects your OS and architecture, downloads the correct binary, verifies the checksum, and installs to /usr/local/bin. On macOS it picks the Intel or Apple Silicon build automatically — and because a curl | sh download isn't quarantined, Gatekeeper won't block it (see the note below for browser downloads).

To install to a custom directory:

CCA_INSTALL_DIR=~/.local/bin curl -sSL https://releases.dragonfractal.com/install.sh | sh

Binary Download​

Download pre-built binaries from releases.dragonfractal.com:

PlatformArchive
Linux x86_64cca-linux-amd64.tar.gz
Linux ARM64cca-linux-arm64.tar.gz
macOS (Apple Silicon)cca-macos-arm64.tar.gz
macOS (Intel)cca-macos-amd64.tar.gz
Windows x86_64cca-windows-amd64.tar.gz

Manual install:

# Download
curl -LO https://releases.dragonfractal.com/cca/latest/cca-linux-amd64.tar.gz

# Extract
tar -xzf cca-linux-amd64.tar.gz

# Install
sudo mv cca /usr/local/bin/

# Verify
cca --version

Pin to a specific version:

curl -LO https://releases.dragonfractal.com/cca/v0.1.0/cca-linux-amd64.tar.gz

On macOS, download the archive matching your chip — cca-macos-arm64.tar.gz for Apple Silicon (M1/M2/M3) or cca-macos-amd64.tar.gz for Intel — then extract and move cca onto your PATH the same way.

macOS Gatekeeper​

The macOS binaries are currently unsigned. A tarball downloaded through a browser is quarantined, so the first run may be blocked with "cca cannot be opened because the developer cannot be verified." Clear the quarantine flag after installing:

xattr -d com.apple.quarantine /usr/local/bin/cca

The Quick Install curl | sh path is not affected — prefer it on macOS to skip this step.

Docker​

Run CCA in a container without installing anything:

# Run a scan
docker run --rm \
  -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN \
  dragonfractal/cca:latest \
  scan --api-key YOUR_KEY -r us-east-1

# With AWS credentials file
docker run --rm \
  -v ~/.aws:/root/.aws:ro \
  -e AWS_PROFILE=your-profile \
  dragonfractal/cca:latest \
  scan --api-key YOUR_KEY -r us-east-1

# Pin to a specific version
docker run --rm dragonfractal/cca:v0.1.0 --help

Build from Source​

The source repository is private; building from source requires access. If you have it, use a recent stable Rust toolchain (edition 2021):

git clone https://github.com/DragonFractal/cloud-cost-analyzer.git
cd cloud-cost-analyzer
cargo build --release
sudo cp target/release/cloud-cost-analyzer /usr/local/bin/cca

Most users should install a pre-built binary or use Docker (above) instead.

Verifying Installation​

After installation, verify CCA is working:

# Check version
cca --version

# Display help
cca --help

# Run your first scan (requires API key, sign up at cca.dragonfractal.com)
cca scan --api-key YOUR_KEY -r us-east-1

Troubleshooting​

"command not found" after installation​

Ensure the installation directory is in your PATH:

# Check if cca is in PATH
which cca

# If not found, add to PATH
export PATH="/usr/local/bin:$PATH"

Permission denied on Linux​

Make the binary executable:

chmod +x /usr/local/bin/cca

macOS: "cannot be opened because the developer cannot be verified"​

The macOS binaries are unsigned, so a tarball downloaded through a browser is quarantined by Gatekeeper. Clear the flag (or use the curl | sh Quick Install, which avoids it entirely):

xattr -d com.apple.quarantine /usr/local/bin/cca

Next Steps​