Quickstart: install the infraudit CLI and scan

You can do everything InfraAudit offers — connecting providers, triggering scans, reviewing findings, approving remediations — without leaving your terminal. This guide gets you from a fresh install to a completed drift scan in under five minutes. You’ll need your AWS credentials handy.

Install the CLI

macOS (Homebrew)
Linux
Build from source

brew install pratik-mahalle/tap/infraudit

curl -sSL https://infraaudit.dev/install.sh | bash

The script installs the binary to /usr/local/bin/infraudit.

git clone https://github.com/pratik-mahalle/infraudit-go.git
cd infraudit-go
go build -o infraudit ./cmd/cli
sudo mv infraudit /usr/local/bin/

Verify the install:

infraudit version

Point the CLI at your server

SaaS
Self-hosted

infraudit config init
# Server URL: https://api.infraaudit.dev

infraudit config init
# Server URL: http://localhost:8080

Log in

infraudit auth login
# Email: user@example.com
# Password: ••••••••

The CLI stores your session token in ~/.infraudit/config.yaml. Subsequent commands use it automatically — you won’t need to log in again until the token expires. To confirm who you’re logged in as:

infraudit auth whoami

Connect a cloud account

infraudit provider connect aws
# AWS Access Key ID: AKIA...
# AWS Secret Access Key: ••••••••
# Default region [us-east-1]: us-east-1
# Display name [AWS]: Production

Wait for the initial sync to complete before running scans. Check the status with:

infraudit provider list
# ID  NAME        TYPE  STATUS  RESOURCES
# 1   Production  aws   synced  247

The provider is ready when STATUS shows synced.

Run a drift scan

infraudit drift detect
# Drift detection triggered. Job ID: 42
# Waiting for results...
# Found 3 drifts (1 high, 2 medium)

View all findings:

infraudit drift list

Filter by severity to focus on the most important items first:

infraudit drift list --severity high

Inspect a specific finding:

infraudit drift get 1

What to do next

# Run a vulnerability scan
infraudit vuln scan

# Enable the CIS AWS Benchmark and run an assessment
infraudit compliance enable cis-aws
infraudit compliance assess

# Check your cost overview
infraudit cost overview

# Sync billing data immediately
infraudit cost sync

# View AI-powered recommendations
infraudit recommendation list

For the full list of commands and flags, see the CLI command reference or run:

infraudit --help

Get Started

Platform

Integrations

Concepts

Self-Hosting

Resources

Quickstart: install the infraudit CLI and scan

Install the CLI

Point the CLI at your server

Log in

Connect a cloud account

Run a drift scan

What to do next

​Install the CLI

​Point the CLI at your server

​Log in

​Connect a cloud account

​Run a drift scan

​What to do next

Install the CLI

Point the CLI at your server

Log in

Connect a cloud account

Run a drift scan

What to do next