Skip to content

Installation Guide

Detailed steps to install FinFocus on your system.

Prerequisites

Pulumi CLI installed
Go 1.25.8+ (if building from source)
Git (if building from source)
5-10 minutes

Installation Methods

Option 1: Build from Source (For Contributors)

Step 1: Clone the repository

git clone https://github.com/rshade/finfocus
cd finfocus

Step 2: Build

make build

Binary will be created at: bin/finfocus

Step 3: Add to PATH (optional)

# macOS/Linux
export PATH="$PWD/bin:$PATH"

# Or copy to system path
sudo cp bin/finfocus /usr/local/bin/

Step 4: Verify

finfocus --version
finfocus --help

Option 2: Install Script (Recommended)

The install script automatically detects your platform, downloads the correct binary, verifies its checksum, and installs it.

curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh

Or with wget:

wget -qO- https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh

Environment Variables

Variable	Description	Default
`FINFOCUS_VERSION`	Install a specific version	Latest release
`FINFOCUS_INSTALL_DIR`	Custom install directory	`/usr/local/bin` or `~/bin`
`FINFOCUS_NO_VERIFY`	Skip checksum verification	Unset (verify enabled)

Examples

# Install a specific version (export so the piped shell inherits the variable)
export FINFOCUS_VERSION=v0.2.0
curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh

# Or pass the variable inline to the shell that runs the script
curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | FINFOCUS_VERSION=v0.2.0 sh

# Install to a custom directory
export FINFOCUS_INSTALL_DIR=$HOME/bin
curl -fsSL https://raw.githubusercontent.com/rshade/finfocus/main/scripts/install.sh | sh

Option 3: Docker

docker run ghcr.io/rshade/finfocus:latest cost projected --help

Verification

# Check version
finfocus --version

# Test with example plan
finfocus cost projected --pulumi-json examples/plans/aws-simple-plan.json

Next Steps