Install k6 | Grafana k6 documentation (original) (raw)

Open source RSS

k6 has packages for Linux, Mac, and Windows. Alternatively, you can use a Docker container or a standalone binary.

Linux

Debian/Ubuntu

sudo gpg -k
sudo gpg --no-default-keyring --keyring /usr/share/keyrings/k6-archive-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys C5AD17C747E3415A3642D57D77C6C491D6AC1D69
echo "deb [signed-by=/usr/share/keyrings/k6-archive-keyring.gpg] 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

Fedora/CentOS

Using dnf (or yum on older versions):

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

MacOS

UsingHomebrew:

Windows

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

If you use theWindows Package Manager, install the official packages from the k6 manifests(created by the community):

winget install k6 --source winget

Alternatively, you can download and runthe latest official installer.

Docker

We also have a separate image you can use with chromium installed to run k6 browser tests.

docker pull grafana/k6:master-with-browser

Download the k6 binary

OurGitHub Releases page has a standalone binary for all platforms. After downloading and extracting the archive for your platform, place the k6 or k6.exe binary in your PATH to run k6 from any location.

Using k6 extensions

If you use one or morek6 extensions, you need a k6 binary built with your desired extensions. Head toExplore extension to get started.

Troubleshooting

If installation fails, check thelist of common installation issues. If your problem is not listed and persists, reach out via the channel #community-discussion on ourofficial Slack, or report it on ourcommunity forum.

Next steps

Now that you have k6 installed in your machine, you can: