Installation

Linux

Debian/Ubuntu

🧠 If you are using an image that lacks ca-certificates or gnupg2

Some images don't come bundled with the ca-certificates and gnupg2 packages out of the box. If you are using such an image, you first need to install these packages with the following command:

$ sudo apt-get update && sudo apt-get install ca-certificates gnupg2 -y

Copy

$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys C5AD17C747E3415A3642D57D77C6C491D6AC1D69
$ echo "deb https://dl.k6.io/deb stable main" | sudo tee /etc/apt/sources.list.d/k6.list
$ sudo apt-get update
$ sudo apt-get install k6

⚠️ If you are behind a firewall or proxy

There have been reports of users being unable to download the key from Ubuntu's keyserver using the apt-key command due to firewalls or proxies blocking their requests. If you experience this issue, you may try this alternative approach instead:

$ curl -s https://dl.k6.io/key.gpg | sudo apt-key add -

Copy

Then confirm that the key with the above ID is shown in the output of sudo apt-key list.

Fedora/CentOS

Using dnf or yum on older versions:

$ sudo dnf install https://dl.k6.io/rpm/repo.rpm
$ sudo dnf install k6

CentOS versions older than 8 don't support the PGP V4 signature we use, so you'll need to disable the verification by installing k6 with:

$ sudo yum install --nogpgcheck k6

⚠️ Note about Bintray

The Bintray k6 repositories stopped working May 1st, 2021 and you should switch to our own repositories following the instructions above.

On Debian/Ubuntu you can remove the Bintray repository with:

$ sudo sed -i '/dl\.bintray\.com\/loadimpact\/deb/d' /etc/apt/sources.list
$ sudo apt-key del 379CE192D401AB61
$ sudo apt-get update

Copy

And on Fedora/CentOS with:

$ sudo rm /etc/yum.repos.d/bintray-loadimpact-rpm.repo

Copy

macOS

Using Homebrew:

$ brew install k6

Windows

If you use the Chocolatey package manager you can install the unofficial k6 package with:

choco install k6

Otherwise you can manually download and install the latest official .msi package.

Binaries

Download a prebuilt binary from our Releases page, and place it in your PATH to run k6 from any location.

Docker

$ docker pull loadimpact/k6