Installing Artillery CLI
What you'll learn
- How to install the Artillery CLI via
- How to check that your Artillery CLI installation is working
Artillery is a CLI application that is installed on your computer. Artillery runs on Windows, MacOS, and Linux systems and requires the most recent LTS release of Node.js.
The stable release of Artillery is recommended for most users.
Install Artillery via
npm install -g artillery@latest
This will install Artillery globally on your computer.
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
Artillery can also be installed as a dev dependency of a Node.js project with:
npm install -D artillery@latest
We do not recommend installing Artillery as a dependency inside application codebases. This installation method is only recommended for codebases that only contain tests.
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. Open PowerShell as an administrator and use the
Set-ExecutionPolicy to change the execution policy to
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
If you're feeling adventurous, you can install the development release of Artillery:
npm install -g artillery@dev
The dev release is available to check the latest and greatest that's coming to Artillery in the future, or for those who want help test and report bugs. Be warned, things may break! If they do, please let us know via Github Issues.
Checking your installation
If you used
npm to install Artillery globally, run:
If you installed Artillery locally for a project, run the following command from the root folder of that project:
$(npm bin)/artillery dino
You should see an ASCII dinosaur printed to the terminal. Something like this: