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
Quick Install (Recommended)
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):
| Variable | Effect |
|---|---|
CCA_VERSION | Install a specific version, such as v0.3.0 (default: latest) |
CCA_INSTALL_DIR | Install somewhere else (default: %LOCALAPPDATA%\Programs\cca) |
CCA_NO_MODIFY_PATH | Set 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:
| Platform | Archive |
|---|---|
| Linux x86_64 | cca-linux-amd64.tar.gz |
| Linux ARM64 | cca-linux-arm64.tar.gz |
| macOS (Apple Silicon) | cca-macos-arm64.tar.gz |
| Windows x86_64 | cca-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
- CLI Commands - Learn all available commands
- Configuration - Configure default settings
- Quickstart - Run your first scan