Get Artillery

Installing Artillery CLI

Install Artillery via npm:

npm install -g artillery@latest

This will install Artillery globally on your machine.

System requirements

Artillery runs on Windows, MacOS, and Linux systems and requires the most recent LTS release of Node.js (opens in a new tab).

Intellisense in your IDE

If you're using Visual Studio Code, you should also install the Artillery VS Code Extension to get Intellisense (and other features) in Artillery YAML files.

You can also get Intellisense features in other editors.

Common issues

Windows PowerShell

By default, PowerShell sets an execution policy on Windows Desktop clients that prevents the execution of scripts. If you use Windows PowerShell, you may see the following error message when attempting to run Artillery:

artillery: File C:\Users\Artillery\AppData\Roaming\npm\artillery.ps1
cannot be loaded because running scripts is disabled on this system.

To allow your Windows system to use Artillery, you'll need to change the PowerShell execution policy to RemoteSigned (opens in a new tab). Open PowerShell as an administrator and use the Set-ExecutionPolicy to change the execution policy to RemoteSigned:

PS C:\Windows\system32> Set-ExecutionPolicy RemoteSigned

Execution Policy Change
The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose
you to the security risks described in the about_Execution_Policies help topic at
https:/go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): Y

Installing as root in Docker

If you're installing Artillery in a Docker container (or a Docker image, e.g. via RUN npm install -g artillery), make sure the installation is not run as the root user.

Installing as a devDependency in Node.js projects

Generally we do not recommend installing Artillery as a dev dependency inside application codebases (i.e. installing it with npm install -D). The recommended best practice is to maintain a separate repository/project with performance tests and install Artillery as a dependency in that project.

Canary releases

A canary release is published on every new commit to Artillery's GitHub repository. You can install the latest canary release with:

npm install -g artillery@canary

Canary releases are made available to users who want to try the latest changes that haven't been officially released yet, and for users who want help test and report bugs. Be warned, things may break! If they do, please let us know via Github Issues (opens in a new tab).

Checking your installation

Check if Artillery is installed by running:

npx artillery dino

You can also check the version of Artillery you have installed by running:

artillery version