Installation

The kvcdn CLI is distributed as a single x86-64 Linux binary through the kvcdn-cli repository. ARM64 support is planned for a future release.

Download the binary

curl -L https://kvcachestore.com/download/kvcdn -o kvcdn
chmod +x kvcdn
sudo mv kvcdn /usr/local/bin/
kvcdn --version

The CLI source repository is kvcachestore/kvcdn-cli.

git clone https://github.com/kvcachestore/kvcdn-cli
cd kvcdn-cli
cargo build --release
./target/release/kvcdn --help

kvcdn --help

You should see top-level commands such as login, api-key, verify, upload, and benchmark.

The CLI reads configuration from command-line flags or environment variables:

Variable	Default	Description
`KVCDN_API_URL`	`https://api.kvcachestore.com`	Base URL of the hosted portal API
`KVCDN_API_KEY`	—	Bearer token for API-key authentication

For local development, point the CLI at a local portal:

export KVCDN_API_URL=http://localhost:3000
export KVCDN_API_KEY="kv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"