Installation - ZeroPath Documentation

Installation Methods

macOS Intel
macOS ARM (M1/M2)
Linux x64
Windows x64

wget https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-macos -O zeropath
chmod +x zeropath
sudo mv zeropath /usr/local/bin/

wget https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-macos-arm64 -O zeropath
chmod +x zeropath
sudo mv zeropath /usr/local/bin/

wget https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-linux -O zeropath
chmod +x zeropath
sudo mv zeropath /usr/local/bin/

Invoke-WebRequest -Uri https://github.com/ZeroPathAI/zeropath-cli/releases/latest/download/zeropath-windows.exe -OutFile zeropath.exe
move zeropath.exe "C:\Windows\System32\"

Download Latest Release

Get the latest release directly from GitHub

Verify Installation

After installation, verify the CLI is working:

# Check if installed correctly
zeropath --version

# View available commands
zeropath --help

Authentication

Connect the CLI to your ZeroPath account using API credentials:

# Authenticate with your Client ID and Client Secret
zeropath auth <clientId> <clientSecret>

Getting API Credentials

Sign in to ZeroPath Dashboard
Navigate to Settings → API keys (zeropath.com/app/settings/api)
Click Create API Key, enter a Token Name, and click Create Token
Copy the Token ID and Token Secret (the secret is shown only once) and pass them to zeropath auth as <clientId> and <clientSecret>

You create, list and delete API keys only from a signed-in browser session on that page. The CLI cannot manage keys with its own credentials. See API Tokens for key types and expiration.

First Scan

Once authenticated, you can start scanning:

# Scan current directory and save results
zeropath scan . output.sarif

# Scan a specific directory
zeropath scan /path/to/your/project results.sarif

Common Usage Patterns

Local Development

# Quick scan of current project
zeropath scan . results.sarif

# Scan specific directory
zeropath scan ./src output.sarif

CI/CD Integration

# Repository scanning by ID (exits 1 if issues found)
zeropath scan --repository-id <repositoryId>

# Repository scanning by URL
zeropath scan --repository-url https://github.com/owner/repo --vcs github

Next Steps

CLI Introduction - Learn about CLI capabilities
GitHub Repository - Source code and latest releases
API Reference - API documentation for advanced usage

​Installation Methods

Download Latest Release

​Verify Installation

​Authentication

​Getting API Credentials

​First Scan

​Common Usage Patterns

​Local Development

​CI/CD Integration

​Next Steps