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, Apple Silicon), Windows 10 1803+ or Windows 11 (native or WSL; x64, and ARM64 through Windows 11 emulation)
  • Architecture: x86_64 or ARM64 (macOS is Apple Silicon only)
  • 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

Windows​

Paste this into PowerShell or Command Prompt. No admin rights or WSL needed:

powershell -NoProfile -ExecutionPolicy Bypass -c "irm https://releases.dragonfractal.com/install.ps1 | iex"

The installer downloads the build for your machine, verifies its checksum (and stops if it does not match), installs cca.exe to %LOCALAPPDATA%\Programs\cca, and adds that folder to your user PATH. Open a new terminal, then run cca --version. Inside an open PowerShell window you can also run irm https://releases.dragonfractal.com/install.ps1 | iex, and cca then works in that window at once.

-NoProfile keeps your PowerShell profile out of the install. The script also calls every command by its full name, so profiles that replace commands such as mkdir or rm with coreutils do not affect it.

Options, set as environment variables before running it (same names as install.sh):

VariableEffect
CCA_VERSIONInstall a specific version, such as v0.3.0 (default: latest)
CCA_INSTALL_DIRInstall somewhere else (default: %LOCALAPPDATA%\Programs\cca)
CCA_NO_MODIFY_PATHSet to 1 to leave your PATH unchanged

Example: $env:CCA_VERSION = 'v0.3.0'; irm https://releases.dragonfractal.com/install.ps1 | iex

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
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 (Apple Silicon), use cca-macos-arm64.tar.gz, then extract and move cca onto your PATH the same way.

Windows, manual (if you cannot run the installer): in PowerShell:

Invoke-WebRequest https://releases.dragonfractal.com/cca/latest/cca-windows-amd64.tar.gz -OutFile cca.tar.gz -UseBasicParsing
tar -xzf cca.tar.gz
New-Item -ItemType Directory -Force -Path "$env:LOCALAPPDATA\Programs\cca" | Out-Null
Move-Item -Force .\cca.exe "$env:LOCALAPPDATA\Programs\cca\cca.exe"
[Environment]::SetEnvironmentVariable('Path', "$env:LOCALAPPDATA\Programs\cca;" + [Environment]::GetEnvironmentVariable('Path', 'User'), 'User')

Then open a new terminal. tar ships with Windows 10 and later. These commands use full cmdlet names (New-Item, Move-Item), so they work even if your profile replaces mkdir or mv. To check the download, compare Get-FileHash cca.tar.gz with the cca-windows-amd64.tar.gz line in checksums.sha256.

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.

Updating​

Once CCA is installed, upgrade to the latest release in place:

cca update

It checks the release server, downloads the build for your platform, verifies its checksum, and swaps the binary. If you are already current it prints already the latest version and does nothing. When CCA lives in a system directory (such as /usr/local/bin), the swap needs the same permissions you installed with, e.g. sudo cca update.

CCA also prints a one-line notice after a scan when a newer version is available. To silence it, pass --no-update-check or set CCA_NO_UPDATE_CHECK=1.

Reinstall instead. Re-running the installer always lands the latest build and is the simplest path on a locked-down box:

# Linux / macOS
curl -sSL https://releases.dragonfractal.com/install.sh | sh
# Windows (native)
powershell -NoProfile -ExecutionPolicy Bypass -c "irm https://releases.dragonfractal.com/install.ps1 | iex"

Pin to a specific version with CCA_VERSION=v0.2.1 curl ... | sh on Linux/macOS, or $env:CCA_VERSION = 'v0.2.1'; irm https://releases.dragonfractal.com/install.ps1 | iex on Windows.

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​