Installation

The Atlas CLI runs load tests from a terminal or a CI pipeline.

npm install -g @cloudbeat/atlas-cli

Requires Node.js 18 or newer.

Check it worked:

atlas --help
atlas --version

What it can do

Everything the web interface does for running tests: upload files, start and stop runs, read results, and fail a build when a threshold is breached.

It holds no infrastructure credentials — it talks to your Atlas instance, so the same accounts, permissions and limits apply as in the browser.

The recorder is separate

atlas record needs a browser, which CI machines don't. It ships as its own package so a pipeline install stays small:

npm install -g @cloudbeat/atlas-recorder

Install it only where you actually record. atlas record prints this hint if it's missing. See Recorder.

Next

• Signing In
• Commands
• Running in CI