voluum-setup-install

voluum-cli is community-supported software released under the MIT License. It is not an official Voluum product and is not endorsed or supported by Voluum. It uses publicly documented Voluum APIs.

Supported environments

• Linux
• macOS
• Windows through WSL (Ubuntu/Debian recommended)

Prerequisites

• git
• Bun runtime (bun --version)
• Network access to https://api.voluum.com

Install from source

git clone https://github.com/markab21/voluum-cli.git
cd voluum-cli
bun install
bun run build

Optional global CLI link:

bun link
voluum --help

Without linking:

node dist/index.js --help

Configure authentication

Login using Voluum access credentials:

voluum auth login --accessKeyId '<ACCESS_KEY_ID>' --accessKey '<ACCESS_KEY>'

Or use environment variables:

export VOLUUM_BASE_URL="https://api.voluum.com"
export VOLUUM_TOKEN="<SESSION_TOKEN>"

Token storage path:

• ~/.voluum-cli/config.json

First-run verification

voluum --help
voluum reports --help
voluum offers --help
voluum reports query --path /report --query from=2026-02-17T00:00:00Z,to=2026-02-18T00:00:00Z,groupBy=campaign,limit=5 --pretty

Troubleshooting

• bun: command not found: install Bun and restart shell.
• voluum: command not found: rerun bun link or use node dist/index.js.
• No auth token found: run voluum auth login or set VOLUUM_TOKEN.
• WSL users: run install/auth commands inside WSL shell, not PowerShell CMD.